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

O método OnGroupingParamChanged notifica o cliente de que o parâmetro de agrupamento da sessão foi alterado.

Sintaxe

HRESULT OnGroupingParamChanged(
  [in] LPCGUID NewGroupingParam,
  [in] LPCGUID EventContext
);

Parâmetros

[in] NewGroupingParam

O novo parâmetro de agrupamento para a sessão. Esse parâmetro aponta para um GUID de parâmetro de agrupamento.

[in] EventContext

O valor do contexto do evento. Esse é o mesmo valor que o chamador passou para IAudioSessionControl::SetGroupingParam na chamada que alterou o parâmetro de agrupamento 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 IAudioSessionControl::SetGroupingParam altera o parâmetro de agrupamento da sessão.

O parâmetro EventContext fornece um meio para um cliente distinguir entre uma alteração de parâmetro de agrupamento iniciada e uma que algum outro cliente iniciou. Ao chamar o método IAudioSessionControl::SetGroupingParam , um cliente passa um valor de parâmetro EventContext que sua implementação do método OnGroupingParamChanged 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

IAudioSessionControl::SetGroupingParam

IAudioSessionEvents Interface