Méthode IAudioEndpointVolume::GetChannelVolumeLevelScalar (endpointvolume.h)
La méthode GetChannelVolumeLevelScalar obtient le niveau de volume audio-conique normalisé du canal spécifié du flux audio qui entre ou quitte le périphérique de point de terminaison audio.
Syntaxe
HRESULT GetChannelVolumeLevelScalar(
[in] UINT nChannel,
[out] float *pfLevel
);
Paramètres
[in] nChannel
Numéro de canal. Si le flux audio contient n canaux, les canaux sont numérotés de 0 à n– 1. Pour obtenir le nombre de canaux, appelez la méthode IAudioEndpointVolume::GetChannelCount .
[out] pfLevel
Pointeur 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 nChannel est supérieur ou égal au nombre de canaux dans le flux. |
|
Le paramètre pfLevel a la valeur NULL. |
Notes
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.
Spécifications
| 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 |