Share via


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
E_INVALIDARG
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.
AUDCLNT_E_DEVICE_INVALIDATED
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.
AUDCLNT_E_SERVICE_NOT_RUNNING
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

Voir aussi

IAudioStreamVolume, interface

IAudioStreamVolume ::GetChannelCount