Metodo IAudioAutoGainControl::SetEnabled (devicetopology.h)

Il metodo SetEnabled abilita o disabilita l'AGC.

Sintassi

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

Parametri

[in] bEnable

Nuovo stato AGC. Se questo parametro è TRUE (diverso da zero), il metodo abilita AGC. Se FALSE, disabilita AGC.

[in] pguidEventContext

Valore di contesto per il metodo IControlChangeNotify::OnNotify . Questo parametro punta a un GUID del contesto di evento. Se la chiamata SetEnabled modifica lo stato del controllo AGC, tutti i client che hanno registrato interfacce IControlChangeNotify con tale controllo ricevono notifiche. Nell'implementazione del metodo OnNotify , un client può esaminare il GUID del contesto di evento per individuare se è l'origine dell'evento di modifica del controllo o di un altro client. Se il chiamante fornisce un puntatore NULL per questo parametro, il metodo di notifica del client riceve un puntatore di contesto NULL .

Valore restituito

Se il metodo ha esito positivo, viene restituito S_OK. Se ha esito negativo, i possibili codici restituiti includono, ma non sono limitati, i valori illustrati nella tabella seguente.

Codice restituito	Descrizione
E_OUTOFMEMORY	Memoria insufficiente.

Commenti

Un controllo AGC disabilitato opera in modalità pass-through. In questa modalità, il flusso audio passa attraverso il controllo senza modifiche.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	devicetopology.h

Vedi anche

Interfaccia IAudioAutoGainControl