Compartir a través de

Interfaz IAudioTreble (devicetopology.h)

  • Artículo

La interfaz IAudioTreble proporciona acceso a un control de nivel de treble de hardware. El cliente obtiene una referencia a la interfaz IAudioTreble de una subunidad llamando al método IPart::Activate con el parámetro refiid establecido en REFIID IID_IAudioTreble. La llamada a IPart::Activate solo se realiza correctamente si la subunidad admite la interfaz IAudioTreble . Solo un objeto de subunidad que represente una función de hardware para controlar el nivel de las frecuencias de treble en cada canal admitirá esta interfaz.

La interfaz IAudioTreble proporciona controles por canal para establecer y obtener el nivel de ganancia o atenuación de las frecuencias de treble en la secuencia de audio. Si un control de hardware de nivel de treble solo puede atenuar los canales de la secuencia de audio, el nivel máximo de treble para cualquier canal es 0 dB. Si un control de nivel de treble puede proporcionar ganancia (amplificación), el nivel máximo de treble 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 IAudioTreble proporciona un acceso cómodo a la propiedad KSPROPERTY_AUDIO_TREBLE de una subunidad que tiene un valor GUID de subtipo de KSNODETYPE_TONE. 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 IAudioTreble hereda de la interfaz IPerChannelDbLevel.

Requisitos

   
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)