Méthode IAudioStreamVolume ::SetAllVolumes (audioclient.h)

Article
08/22/2023

La méthode SetAllVolumes définit les niveaux de volume individuels pour tous les canaux du flux audio.

Syntaxe

HRESULT SetAllVolumes(
  [in] UINT32      dwCount,
  [in] const float *pfVolumes
);

Paramètres

[in] dwCount

Nombre d’éléments dans le tableau pfVolumes . Ce paramètre doit être égal au nombre de canaux au format de flux. Pour obtenir le nombre de canaux, appelez la méthode IAudioStreamVolume ::GetChannelCount .

[in] pfVolumes

Pointeur vers un tableau de niveaux de volume pour les canaux dans le flux audio. Le nombre d’éléments dans le tableau pfVolumes est spécifié par le paramètre dwCount . L’appelant écrit le niveau de volume de chaque canal dans l’élément tableau dont l’index correspond au numéro de canal. Si le format de flux a N canaux, les canaux sont numérotés de 0 à N à 1. 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 dwCount n’est pas égal au nombre de canaux dans le flux, ou la valeur d’un élément de tableau pfVolumes n’est pas comprise entre 0,0 et 1,0.
E_POINTER	Le paramètre pfVolumes a la valeur NULL.
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

Partager via