Método IAudioSessionEvents::OnSimpleVolumeChanged (audiopolicy.h)
El método OnSimpleVolumeChanged notifica al cliente que ha cambiado el nivel de volumen o el estado de silenciación de la sesión de audio.
Sintaxis
HRESULT OnSimpleVolumeChanged(
[in] float NewVolume,
[in] BOOL NewMute,
[in] LPCGUID EventContext
);
Parámetros
[in] NewVolume
Nuevo nivel de volumen para la sesión de audio. Este parámetro es un valor del intervalo de 0,0 a 1,0, donde 0,0 es silencio y 1,0 es volumen completo (sin atenuación).
[in] NewMute
Nuevo estado de silenciamiento. Si es TRUE, se habilita la silenciación. Si es FALSE, se deshabilita la silenciación.
[in] EventContext
Valor del contexto del evento. Este es el mismo valor que el autor de la llamada pasó a ISimpleAudioVolume::SetMasterVolume o ISimpleAudioVolume::SetMute en la llamada que cambió el nivel de volumen o el estado de silenciación de la sesión. Para obtener más información, vea la sección Comentarios.
Valor devuelto
Si el método se realiza correctamente, devuelve S_OK. Si se produce un error, devuelve un código de error.
Comentarios
El administrador de sesiones llama a este método cada vez que una llamada al método ISimpleAudioVolume::SetMasterVolume o ISimpleAudioVolume::SetMute cambia el nivel de volumen o el estado de silenciación de la sesión.
El parámetro EventContext proporciona un medio para que un cliente distinga entre un volumen o un cambio silenciado que inició y otro iniciado por el cliente. Al llamar al método ISimpleAudioVolume::SetMasterVolume o ISimpleAudioVolume::SetMute , un cliente pasa un valor de parámetro EventContext que su implementación del método OnSimpleVolumeChanged puede reconocer.
Para obtener un ejemplo de código que implemente los métodos en la interfaz IAudioSessionEvents , consulte Eventos de sesión de audio.
Requisitos
| Requisito | Value |
|---|---|
| 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 | audiopolicy.h |