Méthode IAudioStreamVolume ::GetAllVolumes (audioclient.h)
La méthode GetAllVolumes récupère les niveaux de volume de tous les canaux du flux 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 obtenir le nombre de canaux, appelez la méthode IAudioStreamVolume ::GetChannelCount .
[out] pfVolumes
Pointeur vers un tableau de niveaux de volume pour les canaux dans le flux 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 |
|---|---|
|
Le paramètre dwCount n’est pas égal au nombre de canaux dans le flux. |
|
Le paramètre pfVolumes a la valeur 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 IAudioStreamVolume ::SetAllVolumes ou IAudioStreamVolume ::SetChannelVolume pour définir les niveaux de volume par canal dans un flux audio.
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 ::GetChannelCount