Méthode IAudioSessionControl ::GetIconPath (audiopolicy.h)

La méthode GetIconPath récupère le chemin d’accès de l’icône d’affichage pour la session audio.

Syntaxe

HRESULT GetIconPath(
  [out] LPWSTR *pRetVal
);

Paramètres

[out] pRetVal

Pointeur vers une variable de pointeur dans laquelle la méthode écrit l’adresse d’une chaîne de caractères larges terminée par null qui spécifie le chemin complet d’un .ico, d’un .dll ou d’un fichier .exe contenant l’icône. La méthode alloue le stockage pour la chaîne. L’appelant est responsable de libérer le stockage, lorsqu’il n’est plus nécessaire, en appelant la fonction CoTaskMemFree . Pour plus d’informations sur les chemins d’icône et CoTaskMemFree, consultez la documentation SDK Windows.

Valeur retournée

Si la méthode réussit, retourne S_OK. En cas d’échec, les codes de retour possibles incluent, sans s’y limiter, les valeurs indiquées dans le tableau suivant.

Code de retour	Description
E_POINTER	Le paramètre pRetVal a la valeur NULL.
E_OUTOFMEMORY	Mémoire insuffisante.
AUDCLNT_E_DEVICE_INVALIDATED	Le périphérique de point de terminaison audio a été débranché, ou le matériel audio ou les ressources matérielles associées ont été reconfigurés, désactivés, supprimés ou autrement indisponibles.
AUDCLNT_E_SERVICE_NOT_RUNNING	Le service audio Windows n’est pas en cours d’exécution.

Remarques

Si un client n’a pas appelé IAudioSessionControl ::SetIconPath pour définir l’icône d’affichage, la chaîne est vide. Si aucune icône spécifiée par le client n’est disponible, le programme Sndvol utilise l’icône de la fenêtre d’application du client pour étiqueter le contrôle de volume pour la 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, interface

IAudioSessionControl ::SetIconPath