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 |