Interface IAudioAutoGainControl (devicetopology.h)

A interface IAudioAutoGainControl fornece acesso a um AGC (controle de ganho automático de hardware). O cliente obtém uma referência à interface IAudioAutoGainControl de uma subunidade chamando o método IPart::Activate com refiid de parâmetro definido como REFIID IID_IAudioAutoGainControl. A chamada para IPart::Activate só terá êxito se a subunidade der suporte à interface IAudioAutoGainControl . Somente um objeto de subunidade que representa uma função AGC de hardware dará suporte a essa interface.

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 IAudioAutoGainControl fornece acesso conveniente à propriedade KSPROPERTY_AUDIO_AGC de uma subunidade que tem um valor GUID de subtipo de KSNODETYPE_AGC. 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 IAudioAutoGainControl herda da interface IUnknown . IAudioAutoGainControl também tem estes tipos de membros:

Métodos

A interface IAudioAutoGainControl tem esses métodos.

IAudioAutoGainControl::GetEnabled O método GetEnabled obtém o estado atual (habilitado ou desabilitado) do AGC.
IAudioAutoGainControl::SetEnabled O método SetEnabled habilita ou desabilita o AGC.

Requisitos

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