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

O método OnDisplayNameChanged notifica o cliente de que o nome de exibição da sessão foi alterado.

Sintaxe

HRESULT OnDisplayNameChanged(
  [in] LPCWSTR NewDisplayName,
  [in] LPCGUID EventContext
);

Parâmetros

[in] NewDisplayName

O novo nome de exibição para a sessão. Esse parâmetro aponta para uma cadeia de caracteres largos terminada em nulo que contém o novo nome de exibição. A cadeia de caracteres permanece válida durante a chamada.

[in] EventContext

O valor do contexto do evento. Esse é o mesmo valor que o chamador passou para IAudioSessionControl::SetDisplayName na chamada que alterou o nome de exibição 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::SetDisplayName altera o nome de exibição da sessão. O programa Sndvol usa o nome de exibição de uma sessão para rotular o controle deslizante de volume para a sessão.

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

IAudioSessionEvents Interface