Método IAudioEndpointVolumeCallback::OnNotify (endpointvolume.h)
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