Partager via


Méthode IAudioSessionManager ::GetSimpleAudioVolume (audiopolicy.h)

La méthode GetSimpleAudioVolume récupère un contrôle de volume audio simple.

Syntaxe

HRESULT GetSimpleAudioVolume(
  [in]  LPCGUID            AudioSessionGuid,
  [in]  DWORD              StreamFlags,
  [out] ISimpleAudioVolume **AudioVolume
);

Paramètres

[in] AudioSessionGuid

Pointeur vers un GUID de session. Si le GUID n’identifie pas une session qui a été précédemment ouverte, l’appel ouvre une nouvelle session vide. Le programme Sndvol n’affiche pas de contrôle au niveau du volume pour une session, sauf s’il contient un ou plusieurs flux actifs. Si ce paramètre a la valeur NULL ou pointe vers la valeur GUID_NULL, la méthode affecte le flux à la session par défaut.

[in] StreamFlags

Spécifie si la demande concerne une session interprocesseur. Définissez sur TRUE si la session est interprocessé. Définissez sur FALSE si la session n’est pas interprocessé.

[out] AudioVolume

Pointeur vers une variable pointeur dans laquelle la méthode écrit un pointeur vers l’interface ISimpleAudioVolume de l’objet de contrôle de volume audio. Cette interface représente le contrôle de volume audio simple pour le processus actuel. L’appelant est chargé de libérer l’interface, quand elle n’est plus nécessaire, en appelant la méthode Release de l’interface. Si l’appel Activer échoue, *AudioVolume a la valeur NULL.

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
AUDCLNT_E_NOT_INITIALIZED
Le flux audio n’a pas été correctement initialisé.
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 rendus indisponibles.
AUDCLNT_E_SERVICE_NOT_RUNNING
Le service audio Windows n’est pas en cours d’exécution.
E_POINTER
Le paramètre AudioVolume a la valeur NULL.
E_MEMORY
Mémoire insuffisante.

Configuration requise

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

Voir aussi

IAudioSessionManager, interface

ISimpleAudioVolume, interface