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