Share via

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

  • Artigo

O método OnIconPathChanged notifica o cliente de que o ícone de exibição da sessão foi alterado.

Sintaxe

HRESULT OnIconPathChanged(
  [in] LPCWSTR NewIconPath,
  [in] LPCGUID EventContext
);

Parâmetros

[in] NewIconPath

O caminho para o novo ícone de exibição da sessão. Esse parâmetro aponta para uma cadeia de caracteres que contém o caminho do novo ícone. O ponteiro de cadeia de caracteres permanece válido apenas durante a chamada.

[in] EventContext

O valor do contexto do evento. Esse é o mesmo valor que o chamador passou para IAudioSessionControl::SetIconPath na chamada que alterou o ícone 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::SetIconPath altera o ícone de exibição da sessão. O programa Sndvol usa o ícone 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 ícone de exibição iniciada e uma que algum outro cliente iniciou. Ao chamar o método IAudioSessionControl::SetIconPath , um cliente passa um valor de parâmetro EventContext que sua implementação do método OnIconPathChanged 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

Requisito Valor
Cliente mínimo com suporte Windows Vista [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho audiopolicy.h

Confira também

IAudioSessionControl::SetIconPath

IAudioSessionEvents Interface