Partager via


Méthode IAudioEndpointVolume ::VolumeStepDown (endpointvolume.h)

La méthode VolumeStepDown décrémente, d’une étape, le niveau de volume du flux audio qui entre ou sort de l’appareil de point de terminaison audio.

Syntaxe

HRESULT VolumeStepDown(
  [in] LPCGUID pguidEventContext
);

Paramètres

[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 VolumeStepDown 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 est la source de l’événement de changement de volume ou d’un autre client. Si l’appelant fournit un pointeur NULL pour ce paramètre, la méthode de notification du client reçoit un pointeur de contexte 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_OUTOFMEMORY
Mémoire insuffisante.

Remarques

Pour obtenir l’étape de volume actuelle et le nombre total d’étapes dans la plage de volumes, appelez la méthode IAudioEndpointVolume ::GetVolumeStepInfo .

Si le niveau de volume est déjà à l’étape la plus basse de la plage de volumes, l’appel à VolumeStepDown n’a aucun effet et retourne status code S_OK.

Les intervalles successifs entre les étapes adjacentes ne représentent pas nécessairement des incréments de volume uniformes dans l’amplitude du signal linéaire ou les décibels. Dans Windows Vista, VolumeStepDown définit la relation de l’index d’étape au niveau du volume (amplitude du signal) pour être une courbe audio-cononique. Notez que la forme de la courbe peut changer dans les versions futures de Windows. Pour plus d’informations sur les courbes à coniques audio, consultez Contrôles de volume à coniques audio.

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

Voir aussi

IAudioEndpointVolume, interface

IAudioEndpointVolume ::GetVolumeStepInfo

IAudioEndpointVolumeCallback, interface

IAudioEndpointVolumeCallback ::OnNotify