Méthode IAudioStreamVolume ::SetChannelVolume (audioclient.h)
La méthode SetChannelVolume définit le niveau de volume du canal spécifié dans le flux audio.
Syntaxe
HRESULT SetChannelVolume(
[in] UINT32 dwIndex,
[in] const float fLevel
);
Paramètres
[in] dwIndex
Numéro de canal. Si le format de flux a N canaux, les canaux sont numérotés de 0 à N à 1. Pour obtenir le nombre de canaux, appelez la méthode IAudioStreamVolume ::GetChannelCount .
[in] fLevel
Niveau de volume du canal. Les niveaux de volume valides sont comprises 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, ou le paramètre fLevel n’est pas compris entre 0,0 et 1.0. |
|
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. |
Configuration requise
| Condition requise | Valeur |
|---|---|
| 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 |