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

La méthode GetChannelVolumeLevel obtient le niveau de volume, en décibels, du canal spécifié dans le flux audio qui entre ou quitte le périphérique de point de terminaison audio.

Syntaxe

HRESULT GetChannelVolumeLevel(
  [in]  UINT  nChannel,
  [out] float *pfLevelDB
);

Paramètres

[in] nChannel

Numéro de canal. Si le flux audio a n canaux, les canaux sont numérotés de 0 à n – 1. Pour obtenir le nombre de canaux dans le flux, appelez la méthode IAudioEndpointVolume::GetChannelCount .

[out] pfLevelDB

Pointeur vers une variable float dans laquelle la méthode écrit le niveau de volume en décibels. Pour obtenir la plage de niveaux de volume obtenue à partir de cette méthode, appelez la méthode IAudioEndpointVolume::GetVolumeRange .

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 pfLevelDB a la valeur NULL.

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

IAudioEndpointVolume::GetVolumeRange