Interface IAudioMidrange (devicetopology.h)

A interface IAudioMidrange fornece acesso a um controle de nível médio de hardware. O cliente obtém uma referência à interface IAudioMidrange de uma subunidade chamando o método IPart::Activate com refiid de parâmetro definido como REFIID IID_IAudioMidrange. A chamada para IPart::Activate só terá êxito se a subunidade der suporte à interface IAudioMidrange . Somente um objeto de subunidade que representa uma função de hardware para controlar o nível das frequências de intervalo médio em cada canal dará suporte a essa interface.

A interface IAudioMidrange fornece controles por canal para definir e obter o nível de ganho ou atenuação das frequências de intervalo médio no fluxo de áudio. Se um controle de hardware de nível médio só puder atenuar os canais no fluxo de áudio, o nível médio máximo para qualquer canal será 0 dB. Se um controle de nível médio puder fornecer ganho (amplificação), o nível médio máximo será maior que 0 dB.

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 IAudioMidrange fornece acesso conveniente à propriedade KSPROPERTY_AUDIO_MID de uma subunidade que tem um valor GUID de subtipo de KSNODETYPE_TONE. 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 IAudioMidrange herda da interface IPerChannelDbLevel.

Requisitos

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

IPerChannelDbLevel Interface