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
| 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 |