Metodo IPart::EnumPartsIncoming (devicetopology.h)

Il metodo EnumPartsIncoming ottiene un elenco di tutte le parti in ingresso, ovvero le parti che risiedono su percorsi dati upstream da questa parte.

Sintassi

HRESULT EnumPartsIncoming(
  [out] IPartsList **ppParts
);

Parametri

[out] ppParts

Puntatore a una variabile puntatore in cui il metodo scrive l'indirizzo di un'interfaccia IPartsList che incapsula l'elenco di parti immediatamente a monte da questa parte. Tramite questo metodo, il chiamante ottiene un riferimento contato all'interfaccia. Il chiamante è responsabile del rilascio dell'interfaccia, quando non è più necessario, chiamando il metodo Release dell'interfaccia. Se la chiamata EnumPartsIncoming ha esito negativo, *ppParts è NULL.

Valore restituito

Se il metodo ha esito positivo, restituisce S_OK. Se ha esito negativo, i possibili codici restituiti includono, ma non sono limitati, i valori illustrati nella tabella seguente.

Osservazioni:

Un'applicazione client può attraversare una topologia del dispositivo sulla direzione del flusso di dati audio chiamando in modo iterativo questo metodo in ogni passaggio dell'attraversamento per ottenere l'elenco di parti che si trovano immediatamente a monte dalla parte corrente.

Se questa parte non contiene collegamenti a parti upstream, il metodo restituisce il codice di errore E_NOTFOUND e non crea un elenco di parti (*ppParts è NULL). Ad esempio, il metodo restituisce questo codice di errore se l'interfaccia IPart rappresenta un connettore tramite cui i dati vengono immessi in una topologia del dispositivo.

Requisiti

Vedere anche

Interfaccia IPart

Interfaccia IPartsList