Méthode ISimpleAudioVolume ::GetMasterVolume (audioclient.h)

La méthode GetMasterVolume récupère le niveau de volume client pour la session audio.

Syntaxe

HRESULT GetMasterVolume(
  [out] float *pfLevel
);

Paramètres

[out] pfLevel

Pointeur vers une variable float dans laquelle la méthode écrit le niveau de volume client. Le niveau de volume est une valeur comprise entre 0,0 et 1,0.

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 pfLevel a la valeur NULL.
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.

Remarques

Cette méthode récupère le niveau de volume client pour la session. Il s’agit du niveau de volume défini par le client dans un appel précédent à la méthode ISimpleAudioVolume ::SetMasterVolume .

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

Voir aussi

IAudioClient ::Initialize

ISimpleAudioVolume, interface

ISimpleAudioVolume ::SetMasterVolume