Metodo IPart::EnumPartsOutgoing (devicetopology.h)

Il metodo EnumPartsOutgoing recupera un elenco di tutte le parti in uscita, ovvero le parti che risiedono su percorsi dati downstream da questa parte.

Sintassi

HRESULT EnumPartsOutgoing(
  [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 downstream da questa parte. Tramite questo metodo, il chiamante ottiene un riferimento conteggiato all'interfaccia. Il chiamante è responsabile del rilascio dell'interfaccia, quando non è più necessario, chiamando il metodo Release dell'interfaccia. Se la chiamata EnumPartsOutgoing ha esito negativo, *ppParts è NULL.

Valore restituito

Se il metodo ha esito positivo, viene restituito S_OK. Se ha esito negativo, i codici restituiti possibili includono, ma non sono limitati a, i valori visualizzati nella tabella seguente.

Commenti

Un'applicazione client può attraversare una topologia del dispositivo nella 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 valle dalla parte corrente.

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

Per un esempio di codice che usa il metodo EnumPartsOutgoing , vedere l'implementazione della funzione SelectCaptureDevice in Topologie dispositivo.

Requisiti

Vedi anche

Interfaccia IPart

Interfaccia IPartsList