Condividi tramite


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