Méthode ISimpleAudioVolume ::GetMasterVolume (audioclient.h)
La méthode GetMasterVolume récupère le niveau de volume client pour la session audio.
Syntaxe
HRESULT GetMasterVolume(
[out] float *pfLevel
);
Paramètres
[out] pfLevel
Pointeur vers une variable float dans laquelle la méthode écrit le niveau de volume client. Le niveau de volume est une valeur comprise 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 pfLevel 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 rendus indisponibles. |
|
Le service audio Windows n’est pas en cours d’exécution. |
Remarques
Cette méthode récupère le niveau de volume client pour la session. Il s’agit du niveau de volume défini par le client dans un appel précédent à la méthode ISimpleAudioVolume ::SetMasterVolume .
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows Vista [applications de bureau | applications UWP] |
| Serveur minimal pris en charge | Windows Server 2008 [applications de bureau | applications UWP] |
| Plateforme cible | Windows |
| En-tête | audioclient.h |