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

La méthode OnIconPathChanged avertit le client que l’icône d’affichage de la session a changé.

Syntaxe

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

Paramètres

[in] NewIconPath

Chemin d’accès de la nouvelle icône d’affichage pour la session. Ce paramètre pointe vers une chaîne qui contient le chemin de la nouvelle icône. Le pointeur de chaîne reste valide uniquement pendant la durée de l’appel.

[in] EventContext

Valeur de contexte d’événement. Il s’agit de la même valeur que celle que l’appelant a passée à IAudioSessionControl ::SetIconPath dans l’appel qui a modifié l’icône 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 ::SetIconPath modifie l’icône d’affichage de la session. Le programme Sndvol utilise l’icône 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 une modification d’icône d’affichage qu’il a initiée et une autre modification initiée par un autre client. Lors de l’appel de la méthode IAudioSessionControl ::SetIconPath , un client transmet une valeur de paramètre EventContext que son implémentation de la méthode OnIconPathChanged 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

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

Voir aussi

IAudioSessionControl ::SetIconPath

IAudioSessionEvents, interface