Interface IPart (devicetopology.h)

Artigo
08/23/2023

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 de um objeto conector ou subunidade representa as funções genéricas que são comuns a todas as partes, e a interface IConnector ou ISubunit do objeto representa as funções específicas de um conector ou subunidade. Além disso, uma parte pode dar suporte a uma ou mais interfaces de controle para controlar ou monitorar a função da parte. Por exemplo, o cliente controla uma subunidade de controle de volume por meio de sua interface IAudioVolumeLevel .

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