Partager via


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