IAudioEndpointVolume::SetMasterVolumeLevel, méthode (endpointvolume.h)

La méthode SetMasterVolumeLevel définit le niveau de volume master, en décibels, du flux audio qui entre ou quitte le périphérique de point de terminaison audio.

Syntaxe

HRESULT SetMasterVolumeLevel(
  [in] float   fLevelDB,
  [in] LPCGUID pguidEventContext
);

Paramètres

[in] fLevelDB

La nouvelle master niveau de volume en décibels. Pour obtenir la plage et la granularité des niveaux de volume qui peuvent être définis par cette méthode, appelez la méthode IAudioEndpointVolume::GetVolumeRange .

[in] pguidEventContext

Valeur de contexte pour la méthode IAudioEndpointVolumeCallback::OnNotify . Ce paramètre pointe vers un GUID de contexte d’événement. Si l’appel SetMasterVolumeLevel modifie le niveau de volume du point de terminaison, tous les clients qui ont inscrit des interfaces IAudioEndpointVolumeCallback avec ce point de terminaison recevront des notifications. Dans son implémentation de la méthode OnNotify , un client peut inspecter le GUID de contexte d’événement pour découvrir s’il ou un autre client est la source de l’événement de modification de volume. Si l’appelant fournit un pointeur NULL pour ce paramètre, la routine de notification reçoit la valeur GUID de contexte GUID_NULL.

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 fLevelDB se trouve en dehors de la plage de volumes prise en charge par l’appareil.
E_OUTOFMEMORY
Mémoire insuffisante.

Notes

Si le niveau de volume fLevelDB se trouve en dehors de la plage de volumes signalée par la méthode IAudioEndpointVolume::GetVolumeRange , l’appel SetMasterVolumeLevel échoue et retourne le code d’erreur E_INVALIDARG.

Spécifications

   
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 endpointvolume.h

Voir aussi

IAudioEndpointVolume, interface

IAudioEndpointVolume::GetVolumeRange

IAudioEndpointVolumeCallback, interface

IAudioEndpointVolumeCallback::OnNotify