Interfaccia IPart (devicetopology.h)

L'interfaccia IPart rappresenta una parte (connettore o subunit) di una topologia del dispositivo. Un client ottiene un riferimento a un'interfaccia IPart chiamando il metodo IDeviceTopology::GetPartById o IPartsList::GetPart oppure chiamando il metodo QueryInterface dell'interfaccia IConnector o ISubunit su un oggetto part e impostando il parametro iid del metodo su REFIID IID_IPart.

Un oggetto con un'interfaccia IPart può incapsulare una delle parti della topologia del dispositivo seguenti:

• Connettore. Si tratta di una parte che si connette a un altro dispositivo per formare un percorso dati per la trasmissione di un flusso audio tra dispositivi.
• Subunità. Si tratta di una parte che elabora un flusso audio (ad esempio, il controllo del volume).

L'interfaccia IPart di un connettore o di un oggetto subunit rappresenta le funzioni generiche comuni a tutte le parti e l'interfaccia IConnector o ISubunit dell'oggetto rappresenta le funzioni specifiche di un connettore o di una subunit. Inoltre, una parte potrebbe supportare una o più interfacce di controllo per il controllo o il monitoraggio della funzione della parte. Ad esempio, il client controlla una subunit del controllo volume tramite l'interfaccia IAudioVolumeLevel .

L'interfaccia IPart fornisce metodi per ottenere il nome, l'ID locale, l'ID globale e il tipo di parte di un connettore o di un subunit. Inoltre, IPart può attivare un'interfaccia di controllo su un connettore o subunit.

Per esempi di codice che usano l'interfaccia IPart , vedere le implementazioni delle funzioni GetHardwareDeviceTopology e SelectCaptureDevice in Topologie di dispositivo.

Ereditarietà

L'interfaccia IPart eredita dall'interfaccia IUnknown . IPart include anche questi tipi di membri:

Metodi

L'interfaccia IPart include questi metodi.

IPart::Activate Il metodo Activate attiva un'interfaccia specifica della funzione su un connettore o subunit.
IPart::EnumPartsIncoming 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.
IPart::EnumPartsOutgoing Il metodo EnumPartsOutgoing recupera un elenco di tutte le parti in uscita, ovvero le parti che risiedono su percorsi dati downstream da questa parte.
IPart::GetControlInterface Il metodo GetControlInterface ottiene un riferimento all'interfaccia di controllo specificata, se supportata da questa parte.
IPart::GetControlInterfaceCount Il metodo GetControlInterfaceCount ottiene il numero di interfacce di controllo supportate da questa parte.
IPart::GetGlobalId Il metodo GetGlobalId ottiene l'ID globale di questa parte.
IPart::GetLocalId Il metodo GetLocalId ottiene l'ID locale di questa parte.
IPart::GetName Il metodo GetName ottiene il nome descrittivo di questa parte.
IPart::GetPartType Il metodo GetPartType ottiene il tipo di parte di questa parte.
IPart::GetSubType Il metodo GetSubType ottiene il sottotipo della parte di questa parte.
IPart::GetTopologyObject Il metodo GetTopologyObject ottiene un riferimento all'interfaccia IDeviceTopology dell'oggetto topologia del dispositivo che contiene questa parte.
IPart::RegisterControlChangeCallback Il metodo RegisterControlChangeCallback registra l'interfaccia IControlChangeNotify, che il client implementa per ricevere notifiche di modifiche dello stato in questa parte.
IPart::UnregisterControlChangeCallback Il metodo UnregisterControlChangeCallback rimuove la registrazione di un'interfaccia IControlChangeNotify registrata in precedenza dal client tramite una chiamata al metodo IPart::RegisterControlChangeCallback.

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

Interfacce audio di base

DeviceTopology API

Interfaccia IAudioVolumeLevel

Interfaccia IConnector

IDeviceTopology::GetPartById

IPartsList::GetPart

Interfaccia ISubunit