Share via

Méthode IAudioEndpointVolume ::GetMasterVolumeLevelScalar (endpointvolume.h)

  • Article

La méthode GetMasterVolumeLevelScalar obtient le niveau de volume master du flux audio qui entre ou quitte le périphérique de point de terminaison audio. Le niveau de volume est exprimé sous la forme d’une valeur audio-conique normalisée dans la plage comprise entre 0,0 et 1,0.

Syntaxe

HRESULT GetMasterVolumeLevelScalar(
  [out] float *pfLevel
);

Paramètres

[out] pfLevel

Pointeur vers le niveau de volume master. Ce paramètre pointe vers une variable float dans laquelle la méthode écrit le niveau de volume. Le niveau est exprimé sous la forme d’une valeur normalisée dans la plage 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.

Remarques

Le niveau de volume est normalisé à la plage comprise entre 0,0 et 1,0, où 0,0 est le niveau de volume minimal et 1,0 le niveau maximal. Dans cette plage, la relation entre le niveau de volume normalisé et l’atténuation de l’amplitude du signal est décrite par une courbe audio-conique non linéaire. Notez que la forme de la courbe peut changer dans les versions ultérieures de Windows. Pour plus d’informations sur les courbes audio-coniques, consultez Contrôles de volume audio-conique.

Les niveaux de volume normalisés récupérés par cette méthode sont appropriés pour représenter les positions des contrôles de volume dans les fenêtres d’application et les affichages à l’écran.

Pour obtenir un exemple de code qui appelle GetMasterVolumeLevelScalar, consultez Endpoint Volume Controls.

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

Voir aussi

IAudioEndpointVolume, interface