Interface IAudioTreble (devicetopology.h)

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

A interface IAudioTreble fornece controles por canal para definir e obter o nível de ganho ou atenuação das frequências de agudos no fluxo de áudio. Se um controle de hardware de nível agudo só puder atenuar os canais no fluxo de áudio, o nível máximo de agudos para qualquer canal será 0 dB. Se um controle de nível agudo puder fornecer ganho (amplificação), o nível máximo de agudos 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 IAudioTreble fornece acesso conveniente à propriedade KSPROPERTY_AUDIO_TREBLE 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 IAudioTreble herda da interface IPerChannelDbLevel.

Requisitos

Confira também

Principais interfaces de áudio

DeviceTopology API

IPart::Activate

IPerChannelDbLevel Interface