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.
| Code de retour | Description |
|---|---|
|
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 |