Méthode IAudioAutoGainControl ::SetEnabled (devicetopology.h)

Article
02/26/2024

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

Syntaxe

HRESULT SetEnabled(
  [in] BOOL    bEnable,
  [in] LPCGUID pguidEventContext
);

Paramètres

[in] bEnable

Nouvel état AGC. Si ce paramètre est TRUE (différent de zéro), la méthode active AGC. Si la valeur est FALSE, elle désactive AGC.

[in] pguidEventContext

Valeur de contexte pour la méthode IControlChangeNotify ::OnNotify . Ce paramètre pointe vers un GUID de contexte d’événement. Si l’appel SetEnabled modifie l’état du contrôle AGC, tous les clients qui ont des interfaces IControlChangeNotify inscrites avec ce contrôle reçoivent des notifications. Dans son implémentation de la méthode OnNotify , un client peut inspecter le GUID de contexte d’événement pour déterminer s’il est ou un autre client la source de l’événement control-change. Si l’appelant fournit un pointeur NULL pour ce paramètre, la méthode de notification du client reçoit un pointeur de contexte NULL .

Valeur retournée

Si la méthode réussit, retourne S_OK. En cas d’échec, les codes de retour possibles incluent, sans s’y limiter, les valeurs indiquées dans le tableau suivant.

Code de retour	Description
E_OUTOFMEMORY	Mémoire insuffisante.

Remarques

Un contrôle AGC désactivé fonctionne en mode direct. Dans ce mode, le flux audio passe par le contrôle sans modification.

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

IAudioAutoGainControl, interface

Partager via