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.
| Codice restituito | Descrizione |
|---|---|
|
Il puntatore ppParts è NULL. |
|
Questa parte non include collegamenti alle parti downstream. |
|
Memoria insufficiente. |
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
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows Vista [solo app desktop] |
| Server minimo supportato | Windows Server 2008 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | devicetopology.h |