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

Confira também

Principais interfaces de áudio

DeviceTopology API

IAudioVolumeLevel Interface

IConnector Interface

IDeviceTopology::GetPartById

IPartsList::GetPart

ISubunit Interface