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