Interfaz IAudioVolumeLevel (devicetopology.h)

  • Artículo

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

La interfaz IAudioVolumeLevel proporciona controles por canal para establecer y obtener los niveles de ganancia o atenuación en la secuencia de audio. Si un control de hardware de nivel de volumen solo puede atenuar los canales de la secuencia de audio, el nivel máximo de volumen de cualquier canal es 0 dB. Si un control de nivel de volumen puede proporcionar ganancia (amplificación), el nivel de volumen máximo es mayor que 0 dB.

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 IAudioVolumeLevel proporciona un acceso cómodo a la propiedad KSPROPERTY_AUDIO_VOLUMELEVEL de una subunidad que tiene un valor GUID de subtipo de KSNODETYPE_VOLUME. 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 IAudioVolumeLevel hereda de la interfaz IPerChannelDbLevel.

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

IPerChannelDbLevel (Interfaz)