IChannelAudioVolume::GetAllVolumes, méthode (audioclient.h)

Article
08/22/2023

La méthode GetAllVolumes récupère les niveaux de volume pour tous les canaux de la session audio.

Syntaxe

HRESULT GetAllVolumes(
  [in]  UINT32 dwCount,
  [out] float  *pfVolumes
);

Paramètres

[in] dwCount

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

[out] pfVolumes

Pointeur vers un tableau de niveaux de volume pour les canaux de la session audio. Ce paramètre pointe vers un tableau float alloué à l’appelant dans lequel la méthode écrit les niveaux de volume pour les canaux individuels. Les niveaux de volume 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 au format de flux pour la session audio.
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.

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

IChannelAudioVolume::SetAllVolumes

IChannelAudioVolume::SetChannelVolume

Share via