Interface IDeviceTopology (devicetopology.h)

A interface IDeviceTopology fornece acesso à topologia de um dispositivo de áudio. A topologia de um dispositivo adaptador de áudio consiste nos caminhos de dados que levam de e para dispositivos de ponto de extremidade de áudio e dos pontos de controle que estão ao longo dos caminhos. Um dispositivo de ponto de extremidade de áudio também tem uma topologia, mas é trivial, conforme explicado em Topologias de Dispositivo. Um cliente obtém uma referência à interface IDeviceTopology para um dispositivo de ponto de extremidade de áudio seguindo estas etapas:

  1. Usando uma das técnicas descritas na Interface IMMDevice, obtenha uma referência à interface IMMDevice para um dispositivo de ponto de extremidade de áudio.
  2. Chame o método IMMDevice::Activate com refiid de parâmetro definido como REFIID IID_IDeviceTopology.
Depois de obter a interface IDeviceTopology para um dispositivo de ponto de extremidade de áudio, um aplicativo pode explorar as topologias dos dispositivos do adaptador de áudio aos quais o dispositivo de ponto de extremidade está conectado.

Para obter exemplos de código que usam a interface IDeviceTopology , consulte as implementações das funções GetHardwareDeviceTopology e SelectCaptureDevice em Topologias de Dispositivo.

Herança

A interface IDeviceTopology herda da interface IUnknown . IDeviceTopology também tem esses tipos de membros:

Métodos

A interface IDeviceTopology tem esses métodos.

 
IDeviceTopology::GetConnector

O método GetConnector obtém o conector especificado por um número do conector.
IDeviceTopology::GetConnectorCount

O método GetConnectorCount obtém o número de conectores no objeto device-topology.
IDeviceTopology::GetDeviceId

O método GetDeviceId obtém o identificador de dispositivo do dispositivo representado pelo objeto device-topology.
IDeviceTopology::GetPartById

O método GetPartById obtém uma parte identificada por sua ID local.
IDeviceTopology::GetSignalPath

O método GetSignalPath obtém uma lista de partes no caminho de sinal que vincula duas partes, se o caminho existir.
IDeviceTopology::GetSubunit

O método GetSubunit obtém a subunidade especificada por um número de subunidade.
IDeviceTopology::GetSubunitCount

O método GetSubunitCount obtém o número de subunidades na topologia do dispositivo.

Requisitos

   
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

IMMDevice::Activate