Share via

Método IAudioEndpointVolumeCallback::OnNotify (endpointvolume.h)

  • Artigo

O método OnNotify notifica o cliente de que o nível de volume ou o estado de mudo do dispositivo de ponto de extremidade de áudio foi alterado.

Sintaxe

HRESULT OnNotify(
  [in] PAUDIO_VOLUME_NOTIFICATION_DATA pNotify
);

Parâmetros

[in] pNotify

Ponteiro para os dados de notificação por volume. Esse parâmetro aponta para uma estrutura do tipo AUDIO_VOLUME_NOTIFICATION_DATA.

Retornar valor

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

Comentários

O parâmetro pNotify aponta para uma estrutura que descreve o evento de alteração de volume que iniciou a chamada para OnNotify. Essa estrutura contém um GUID de contexto de evento. Esse GUID permite que um cliente distingue entre uma alteração de volume (ou muting) iniciada por ele e uma que algum outro cliente iniciou. Ao chamar um método IAudioEndpointVolume que altera o nível de volume do fluxo, um cliente passa um ponteiro para um GUID de contexto de evento que sua implementação do método OnNotify pode reconhecer. A estrutura apontada por pNotify contém esse GUID de contexto. Se o cliente que altera o nível de volume fornecer um valor de ponteiro NULL para o ponteiro para o GUID de contexto de evento, o valor do GUID de contexto de evento na estrutura apontada por pNotify será GUID_NULL.

O Windows 7, a interface do usuário de volume do sistema não especifica GUID_NULL quando altera o volume no sistema. Um aplicativo OSD de terceiros pode diferenciar entre master alterações de controle de volume resultantes da interface do usuário de volume do sistema e outras alterações de volume, como alterações do manipulador de controle de volume interno.

Para obter um exemplo de código que implementa o método OnNotify , consulte Controles de Volume de Ponto de Extremidade.

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 endpointvolume.h

Confira também

AUDIO_VOLUME_NOTIFICATION_DATA

IAudioEndpointVolume Interface

IAudioEndpointVolumeCallback Interface