Méthode IChannelAudioVolume::GetChannelVolume (audioclient.h)
La méthode GetChannelVolume récupère le niveau de volume du canal spécifié dans la session audio.
Syntaxe
HRESULT GetChannelVolume(
[in] UINT32 dwIndex,
[out] float *pfLevel
);
Paramètres
[in] dwIndex
Numéro de canal. Si le format de flux de la session audio comporte N canaux, les canaux sont numérotés de 0 à N– 1. Pour obtenir le nombre de canaux, appelez la méthode IChannelAudioVolume::GetChannelCount .
[out] pfLevel
Pointeur vers une variable float dans laquelle la méthode écrit le niveau de volume du canal spécifié. Le niveau de volume se situe 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 dwIndex est défini sur un numéro de canal non valide. |
|
Le paramètre pfLevel a lavaleur NULL. |
|
Le périphérique de point de terminaison audio a été débranché, ou le matériel audio ou les ressources matérielles associées ont été reconfigurés, désactivés, supprimés ou autrement indisponibles. |
|
Le service audio Windows n’est pas en cours d’exécution. |
Remarques
Les clients peuvent appeler la méthode IChannelAudioVolume::SetAllVolumes ou IChannelAudioVolume::SetChannelVolume pour définir les niveaux de volume par canal dans une session audio.
Configuration requise
| Client minimal pris en charge | Windows Vista [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2008 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | audioclient.h |
Voir aussi
IChannelAudioVolume, interface
IChannelAudioVolume::GetChannelCount