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 che sono a monte 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 upstream 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 EnumPartsIncoming 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 upstream. |
|
Memoria insufficiente. |
Commenti
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 entrano in una topologia del 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 |