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

Consulte también

Interfaz IAudioSessionEvents

ISimpleAudioVolume::SetMasterVolume

ISimpleAudioVolume::SetMute