Método IAudioEndpointVolume::SetMute (endpointvolume.h)

  • Artículo

El método SetMute establece el estado de silenciamiento de la secuencia de audio que entra o sale del dispositivo de punto de conexión de audio.

Sintaxis

HRESULT SetMute(
  [in] BOOL    bMute,
  [in] LPCGUID pguidEventContext
);

Parámetros

[in] bMute

Nuevo estado de silenciamiento. Si bMute es TRUE, el métodomuta la secuencia. Si es FALSE, el método desactiva la silenciación.

[in] pguidEventContext

Valor de contexto del método IAudioEndpointVolumeCallback::OnNotify . Este parámetro apunta a un GUID de contexto de evento. Si la llamada SetMute cambia el estado de silenciamiento del punto de conexión, todos los clientes que han registrado interfaces IAudioEndpointVolumeCallback con ese punto de conexión recibirán notificaciones. En su implementación del método OnNotify , un cliente puede inspeccionar el GUID de contexto de evento para detectar si es el origen del evento de cambio de control u otro cliente. Si el autor de la llamada proporciona un puntero NULL para este parámetro, la rutina de notificación recibe el valor guid de contexto GUID_NULL.

Valor devuelto

Si el método se realiza correctamente y cambia el estado de silenciamiento, el método devuelve S_OK. Si el método se realiza correctamente y el nuevo estado de silenciamiento es el mismo que el estado de silenciamiento anterior, el método devuelve S_FALSE. Si se produce un error en el método, los posibles códigos de retorno incluyen, entre otros, los valores que se muestran en la tabla siguiente.

Código devuelto Descripción
E_OUTOFMEMORY
 Memoria insuficiente

Comentarios

Para obtener un ejemplo de código que llama a SetMute, consulte Controles de volumen de punto de conexión.

Requisitos

   
Cliente mínimo compatible Windows Vista [aplicaciones de escritorio | aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2008 [aplicaciones de escritorio | aplicaciones para UWP]
Plataforma de destino Windows
Encabezado endpointvolume.h

Consulte también

IAudioEndpointVolume (interfaz)

IAudioEndpointVolumeCallback (Interfaz)

IAudioEndpointVolumeCallback::OnNotify