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 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 |