Interfaz IAudioChannelConfig (devicetopology.h)

La interfaz IAudioChannelConfig proporciona acceso a un control de configuración de canal de hardware. El cliente obtiene una referencia a la interfaz IAudioChannelConfig de una subunidad llamando al método IPart::Activate con el parámetro refiid establecido en REFIID IID_IAudioChannelConfig. La llamada a IPart::Activate solo se realiza correctamente si la subunidad admite la interfaz IAudioChannelConfig . Solo un objeto de subunidad que representa un control de configuración de canal de hardware admitirá esta interfaz.

Un cliente de la interfaz IAudioChannelConfig programa un control de configuración de canal de hardware escribiendo una máscara de configuración de canal en el control. La máscara especifica la asignación de canales de audio a los altavoces. Para obtener más información sobre las máscaras de configuración de canal, consulte KSPROPERTY_AUDIO_CHANNEL_CONFIG.

La mayoría de los controladores de adaptador de audio de Windows admiten el modelo de controlador de Windows (WDM) y usan propiedades de streaming de kernel (KS) para representar los parámetros de control de hardware en subunits (denominados nodos KS). La interfaz IAudioChannelConfig proporciona un acceso cómodo a la propiedad KSPROPERTY_AUDIO_CHANNEL_CONFIG de una subunidad que tiene un valor GUID de subtipo de KSNODETYPE_3D_EFFECTS, KSNODETYPE_DAC, KSNODETYPE_VOLUME o KSNODETYPE_PROLOGIC_DECODER. Para obtener el GUID de subtipo de una subunidad, llame al método IPart::GetSubType . Para obtener más información sobre las propiedades KS y los tipos de nodo KS, consulte la documentación de Windows DDK.

Herencia

La interfaz IAudioChannelConfig hereda de la interfaz IUnknown . IAudioChannelConfig también tiene estos tipos de miembros:

Métodos

La interfaz IAudioChannelConfig tiene estos métodos.

IAudioChannelConfig::GetChannelConfig El método GetChannelConfig obtiene la máscara de configuración de canal actual de un control de configuración de canal.
IAudioChannelConfig::SetChannelConfig El método SetChannelConfig establece la máscara de configuración de canal en un control de configuración de canal.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	devicetopology.h

Consulte también

Interfaces de audio principales

DeviceTopology API

IPart::Activate