Condividi tramite


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
E_POINTER
Il puntatore ppParts è NULL.
E_NOTFOUND
Questa parte non include collegamenti alle parti upstream.
E_OUTOFMEMORY
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

Vedi anche

Interfaccia IPart

Interfaccia IPartsList