Share via


Interface IAudioChannelConfig (devicetopology.h)

A interface IAudioChannelConfig fornece acesso a um controle de configuração de canal de hardware. O cliente obtém uma referência à interface IAudioChannelConfig de uma subunidade chamando o método IPart::Activate com refiid de parâmetro definido como REFIID IID_IAudioChannelConfig. A chamada para IPart::Activate só terá êxito se a subunidade der suporte à interface IAudioChannelConfig . Somente um objeto de subunidade que representa um controle de configuração de canal de hardware dará suporte a essa interface.

Um cliente da interface IAudioChannelConfig programa um controle de configuração de canal de hardware escrevendo uma máscara de configuração de canal no controle. A máscara especifica a atribuição de canais de áudio aos alto-falantes. Para obter mais informações sobre máscaras de configuração de canal, consulte KSPROPERTY_AUDIO_CHANNEL_CONFIG.

A maioria dos drivers de adaptador de áudio do Windows dá suporte ao WDM (Modelo de Driver do Windows) e usa propriedades de KS (streaming de kernel) para representar os parâmetros de controle de hardware em subunidades (conhecidos como nós KS). A interface IAudioChannelConfig fornece acesso conveniente à propriedade KSPROPERTY_AUDIO_CHANNEL_CONFIG de uma subunidade que tem um valor GUID de subtipo de KSNODETYPE_3D_EFFECTS, KSNODETYPE_DAC, KSNODETYPE_VOLUME ou KSNODETYPE_PROLOGIC_DECODER. Para obter o GUID do subtipo de uma subunidade, chame o método IPart::GetSubType . Para obter mais informações sobre propriedades KS e tipos de nó KS, consulte a documentação do DDK do Windows.

Herança

A interface IAudioChannelConfig herda da interface IUnknown . IAudioChannelConfig também tem estes tipos de membros:

Métodos

A interface IAudioChannelConfig tem esses métodos.

 
IAudioChannelConfig::GetChannelConfig

O método GetChannelConfig obtém a máscara de configuração de canal atual de um controle de configuração de canal.
IAudioChannelConfig::SetChannelConfig

O método SetChannelConfig define a máscara de configuração de canal em um controle de configuração de canal.

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

IPart::Activate