Método IAudioSessionEvents::OnSimpleVolumeChanged (audiopolicy.h)

O método OnSimpleVolumeChanged notifica o cliente de que o nível de volume ou o estado de mudo da sessão de áudio foi alterado.

Sintaxe

HRESULT OnSimpleVolumeChanged(
  [in] float   NewVolume,
  [in] BOOL    NewMute,
  [in] LPCGUID EventContext
);

Parâmetros

[in] NewVolume

O novo nível de volume para a sessão de áudio. Esse parâmetro é um valor no intervalo de 0,0 a 1,0, em que 0,0 é silêncio e 1,0 é volume completo (sem atenuação).

[in] NewMute

O novo estado de ativação de mudo. Se TRUE, o mudo estará habilitado. Se FALSE, o mudo será desabilitado.

[in] EventContext

O valor do contexto do evento. Esse é o mesmo valor que o chamador passou para ISimpleAudioVolume::SetMasterVolume ou ISimpleAudioVolume::SetMute na chamada que alterou o nível de volume ou o estado de mudo da sessão. Para obter mais informações, consulte Comentários.

Retornar valor

Se o método for bem-sucedido, retornará S_OK. Se falhar, retornará um código de erro.

Comentários

O gerenciador de sessão chama esse método sempre que uma chamada para o método ISimpleAudioVolume::SetMasterVolume ou ISimpleAudioVolume::SetMute altera o nível de volume ou o estado de mudo da sessão.

O parâmetro EventContext fornece um meio para um cliente distinguir entre uma alteração de volume ou mudo iniciada por ele e uma que algum outro cliente iniciou. Ao chamar o método ISimpleAudioVolume::SetMasterVolume ou ISimpleAudioVolume::SetMute , um cliente passa um valor de parâmetro EventContext que sua implementação do método OnSimpleVolumeChanged pode reconhecer.

Para obter um exemplo de código que implementa os métodos na interface IAudioSessionEvents , consulte Eventos de sessão de áudio.

Requisitos

Confira também

IAudioSessionEvents Interface

ISimpleAudioVolume::SetMasterVolume

ISimpleAudioVolume::SetMute