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

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.

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

Voir aussi

IAudioEndpointVolume, interface