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

Article
08/23/2023

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
E_INVALIDARG	Le paramètre nChannel est supérieur ou égal au nombre de canaux dans le flux.
E_POINTER	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

Voir aussi

IAudioEndpointVolume, interface

IAudioEndpointVolume::GetChannelCount

Partager via