Método ISimpleAudioVolume::SetMute (audioclient.h)
El método SetMute establece el estado de silenciamiento de la sesión de audio.
Sintaxis
HRESULT SetMute(
[in] const BOOL bMute,
[in] LPCGUID EventContext
);
Parámetros
[in] bMute
Nuevo estado de silenciamiento. TRUE permite silenciar. FALSE deshabilita la silenciación.
[in] EventContext
Puntero al GUID del contexto de evento. Si una llamada a este método genera un evento de cambio de volumen, el administrador de sesiones envía notificaciones a todos los clientes que han registrado interfaces IAudioSessionEvents con el administrador de sesiones. El administrador de sesiones incluye el valor del puntero EventContext con cada notificación. Al recibir una notificación, un cliente puede determinar si es el origen del evento inspeccionando el valor eventContext . Este esquema depende del cliente que seleccione un valor para este parámetro que sea único entre todos los clientes de la sesión. 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 |
|---|---|
|
El dispositivo de punto de conexión de audio se ha desconectado o el hardware de audio o los recursos de hardware asociados se han reconfigurado, deshabilitado, quitado o no están disponibles para su uso. |
|
El servicio de audio de Windows no se está ejecutando. |
Comentarios
Este método genera un evento de cambio de volumen solo si la llamada al método cambia el estado de exclusión mutua de la sesión de deshabilitada a habilitada o de habilitada a deshabilitada. Por ejemplo, si se habilita la exclusión mutua cuando se produce la llamada y la llamada habilita la silenciación, no se genera ningún evento.
Este método aplica el mismo estado de silenciamiento a todos los canales de la sesión de audio. El dispositivo de punto de conexión siempre aplica silenciar uniformemente todos los canales de la sesión. No hay métodos IChannelAudioVolume para establecer los estados de silenciamiento de canales individuales.
El cliente puede obtener el estado de silenciamiento de la sesión de audio llamando al método SimpleAudioVolume::GetMute .
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 | audioclient.h |