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

  • Artículo

El método SetEnabled habilita o deshabilita el AGC.

Sintaxis

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

Parámetros

[in] bEnable

Nuevo estado de AGC. Si este parámetro es TRUE (distinto de cero), el método habilita AGC. Si es FALSE, deshabilita AGC.

[in] pguidEventContext

Valor de contexto del método IControlChangeNotify::OnNotify . Este parámetro apunta a un GUID de contexto de evento. Si la llamada a SetEnabled cambia el estado del control AGC, todos los clientes que han registrado interfaces IControlChangeNotify con ese control reciben notificaciones. En su implementación del método OnNotify , un cliente puede inspeccionar el GUID del contexto de eventos para detectar si él u otro cliente es el origen del evento de cambio de control. Si el autor de la llamada proporciona un puntero NULL para este parámetro, el método de notificación del cliente recibe un puntero de contexto NULL .

Valor devuelto

Si el método se realiza correctamente, devuelve S_OK. Si se produce un error, los posibles códigos de retorno incluyen, pero no están limitados a, los valores que se muestran en la tabla siguiente.

Código devuelto Descripción
E_OUTOFMEMORY
 Memoria insuficiente

Comentarios

Un control AGC deshabilitado funciona en modo de paso a través. En este modo, la secuencia de audio pasa por el control sin modificaciones.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado devicetopology.h

Consulte también

IAudioAutoGainControl (interfaz)