Compartir a través de

Interfaz IAudioMidrange (devicetopology.h)

  • Artículo

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

La interfaz IAudioMidrange proporciona controles por canal para establecer y obtener el nivel de ganancia o atenuación de las frecuencias de rango medio en la secuencia de audio. Si un control de hardware de nivel medio solo puede atenuar los canales de la secuencia de audio, el nivel máximo de rango medio para cualquier canal es 0 dB. Si un control de nivel medio puede proporcionar ganancia (amplificación), el nivel de rango medio 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 IAudioMidrange proporciona un acceso cómodo a la propiedad KSPROPERTY_AUDIO_MID 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 IAudioMidrange 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)