IAudioSessionEvents ::OnDisplayNameChanged, méthode (audiopolicy.h)

La méthode OnDisplayNameChanged avertit le client que le nom d’affichage de la session a changé.

Syntaxe

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

Paramètres

[in] NewDisplayName

Nouveau nom d’affichage de la session. Ce paramètre pointe vers une chaîne de caractères larges terminée par null contenant le nouveau nom d’affichage. La chaîne reste valide pendant la durée de l’appel.

[in] EventContext

Valeur du contexte d’événement. Il s’agit de la même valeur que celle que l’appelant a passée à IAudioSessionControl ::SetDisplayName dans l’appel qui a modifié le nom d’affichage de la session. Pour plus d'informations, consultez la section Notes.

Valeur retournée

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

Remarques

Le gestionnaire de session appelle cette méthode chaque fois qu’un appel à la méthode IAudioSessionControl ::SetDisplayName modifie le nom d’affichage de la session. Le programme Sndvol utilise le nom d’affichage d’une session pour étiqueter le curseur de volume de la session.

Le paramètre EventContext permet à un client de faire la distinction entre un changement de nom d’affichage qu’il a initié et un autre client. Lors de l’appel de la méthode IAudioSessionControl ::SetDisplayName , un client transmet une valeur de paramètre EventContext que son implémentation de la méthode OnDisplayNameChanged peut reconnaître.

Pour obtenir un exemple de code qui implémente les méthodes dans l’interface IAudioSessionEvents , consultez Événements de session audio.

Configuration requise

Voir aussi

IAudioSessionControl ::SetDisplayName

IAudioSessionEvents Interface