Partager via


Interface IAudioAutoGainControl (devicetopology.h)

L’interface IAudioAutoGainControl permet d’accéder à un contrôle de gain automatique (AGC) matériel. Le client obtient une référence à l’interface IAudioAutoGainControl d’une sous-unité en appelant la méthode IPart ::Activate avec refiid de paramètre défini sur REFIID IID_IAudioAutoGainControl. L’appel à IPart ::Activate réussit uniquement si la sous-unité prend en charge l’interface IAudioAutoGainControl . Seul un objet de sous-unité qui représente une fonction AGC matérielle prend en charge cette interface.

La plupart des pilotes d’adaptateur audio Windows prennent en charge le modèle de pilote Windows (WDM) et utilisent les propriétés KS (kernel-streaming) pour représenter les paramètres de contrôle matériel dans les sous-unités (appelées nœuds KS). L’interface IAudioAutoGainControl fournit un accès pratique à la propriété KSPROPERTY_AUDIO_AGC d’une sous-unité dont la valeur GUID de sous-type est KSNODETYPE_AGC. Pour obtenir le GUID de sous-type d’une sous-unité, appelez la méthode IPart ::GetSubType . Pour plus d’informations sur les propriétés KS et les types de nœuds KS, consultez la documentation du DDK Windows.

Héritage

L’interface IAudioAutoGainControl hérite de l’interface IUnknown. IAudioAutoGainControl a également les types de membres suivants :

Méthodes

L’interface IAudioAutoGainControl a ces méthodes.

 
IAudioAutoGainControl ::GetEnabled

La méthode GetEnabled obtient l’état actuel (activé ou désactivé) de l’AGC.
IAudioAutoGainControl ::SetEnabled

La méthode SetEnabled active ou désactive l’AGC.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau uniquement]
Plateforme cible Windows
En-tête devicetopology.h

Voir aussi

Interfaces audio principales

DeviceTopology API

IPart ::Activate