Méthode IAudioEndpointVolume::VolumeStepUp (endpointvolume.h)
La méthode VolumeStepUp incrémente, d’une étape, le niveau de volume du flux audio qui entre ou quitte le périphérique de point de terminaison audio.
Syntaxe
HRESULT VolumeStepUp(
[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 VolumeStepUp 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 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 |
|---|---|
|
Mémoire insuffisante. |
Notes
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 se trouve déjà à l’étape la plus élevée de la plage de volumes, l’appel à VolumeStepUp n’a aucun effet et renvoie status code S_OK.
Les intervalles successifs entre les étapes adjacentes ne représentent pas nécessairement des incréments de volume uniformes en amplitude de signal linéaire ou en décibels. Dans Windows Vista, VolumeStepUp définit la relation entre l’index d’étape et le niveau de volume (amplitude du signal) comme une courbe de type audio. Notez que la forme de la courbe peut changer dans les versions ultérieures de Windows. Pour plus d’informations sur les courbes audio-coniques, consultez Contrôles de volume audio-conique.
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::GetVolumeStepInfo