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

La méthode OnNotify avertit le client que le niveau de volume ou l’état de désactivation du périphérique de point de terminaison audio a changé.

Syntaxe

HRESULT OnNotify(
  [in] PAUDIO_VOLUME_NOTIFICATION_DATA pNotify
);

Paramètres

[in] pNotify

Pointeur vers les données de notification en volume. Ce paramètre pointe vers une structure de type AUDIO_VOLUME_NOTIFICATION_DATA.

Valeur retournée

Si la méthode réussit, retourne S_OK. En cas d'échec, retourne un code d'erreur.

Remarques

Le paramètre pNotify pointe vers une structure qui décrit l’événement de changement de volume qui a lancé l’appel à OnNotify. Cette structure contient un GUID de contexte d’événement. Ce GUID permet à un client de faire la distinction entre une modification de volume (ou de désactivation) qu’il a initiée et une modification initiée par un autre client. Lors de l’appel d’une méthode IAudioEndpointVolume qui modifie le niveau de volume du flux, un client passe un pointeur vers un GUID de contexte d’événement que son implémentation de la méthode OnNotify peut reconnaître. La structure pointée vers pNotify contient ce GUID de contexte. Si le client qui modifie le niveau du volume fournit une valeur de pointeur NULL pour le pointeur vers le GUID de contexte d’événement, la valeur du GUID de contexte d’événement dans la structure pointée par pNotify est GUID_NULL.

Windows 7, l’interface utilisateur de volume du système ne spécifie pas GUID_NULL lorsqu’il modifie le volume dans le système. Une application OSD tierce peut faire la différence entre master modifications de contrôle de volume qui résultent de l’interface utilisateur de volume du système et d’autres modifications de volume, telles que les modifications du gestionnaire de contrôle de volume intégré.

Pour obtenir un exemple de code qui implémente la méthode OnNotify , consultez Endpoint Volume Controls.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista [applications de bureau | applications UWP]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau | applications UWP]
Plateforme cible Windows
En-tête endpointvolume.h

Voir aussi

AUDIO_VOLUME_NOTIFICATION_DATA

IAudioEndpointVolume, interface

IAudioEndpointVolumeCallback, interface