Interface IPart (devicetopology.h)
A interface IPart representa uma parte (conector ou subunidade) de uma topologia de dispositivo. Um cliente obtém uma referência a uma interface IPart chamando o método IDeviceTopology::GetPartById ou IPartsList::GetPart ou chamando o método QueryInterface da interface IConnector ou ISubunit em um objeto part e definindo o parâmetro iid do método como REFIID IID_IPart.
Um objeto com uma interface IPart pode encapsular uma das seguintes partes de topologia do dispositivo:
- Conector. Essa é uma parte que se conecta a outro dispositivo para formar um caminho de dados para transmitir um fluxo de áudio entre dispositivos.
- Subunit. Essa é uma parte que processa um fluxo de áudio (por exemplo, controle de volume).
A interface IPart fornece métodos para obter o nome, a ID local, a ID global e o tipo de parte de um conector ou subunidade. Além disso, o IPart pode ativar uma interface de controle em um conector ou subunidade.
Para obter exemplos de código que usam a interface IPart , consulte as implementações das funções GetHardwareDeviceTopology e SelectCaptureDevice em Topologias de Dispositivo.
Herança
A interface IPart herda da interface IUnknown . O IPart também tem esses tipos de membros:
Métodos
A interface IPart tem esses métodos.
| IPart::Activate O método Activate ativa uma interface específica de função em um conector ou subunidade. |
| IPart::EnumPartsIncoming O método EnumPartsIncoming obtém uma lista de todas as partes de entrada, ou seja, as partes que residem em caminhos de dados que são upstream desta parte. |
| IPart::EnumPartsOutgoing O método EnumPartsOutgoing recupera uma lista de todas as partes de saída, ou seja, as partes que residem em caminhos de dados que são downstream dessa parte. |
| IPart::GetControlInterface O método GetControlInterface obtém uma referência à interface de controle especificada, se essa parte der suporte a ela. |
| IPart::GetControlInterfaceCount O método GetControlInterfaceCount obtém o número de interfaces de controle compatíveis com essa parte. |
| IPart::GetGlobalId O método GetGlobalId obtém a ID global dessa parte. |
| IPart::GetLocalId O método GetLocalId obtém a ID local desta parte. |
| IPart::GetName O método GetName obtém o nome amigável desta parte. |
| IPart::GetPartType O método GetPartType obtém o tipo de parte desta parte. |
| IPart::GetSubType O método GetSubType obtém o subtipo de parte desta parte. |
| IPart::GetTopologyObject O método GetTopologyObject obtém uma referência à interface IDeviceTopology do objeto device-topology que contém essa parte. |
| IPart::RegisterControlChangeCallback O método RegisterControlChangeCallback registra a interface IControlChangeNotify, que o cliente implementa para receber notificações de status alterações nesta parte. |
| IPart::UnregisterControlChangeCallback O método UnregisterControlChangeCallback remove o registro de uma interface IControlChangeNotify que o cliente registrou anteriormente por uma chamada para o método IPart::RegisterControlChangeCallback. |
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows Vista [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2008 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | devicetopology.h |