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

Artículo
08/23/2023

El método SetEnabled habilita o deshabilita el control de voz.

Sintaxis

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

Parámetros

[in] bEnable

Nuevo estado de voz. Si bEnable es TRUE (distinto de cero), el método habilita la intensidad. Si es FALSE, deshabilita la voz alta.

[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 de voz, 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

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

IAudioLoudness (Interfaz)