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

Article
08/22/2023

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

Partager via