IAudioSessionEvents ::OnSimpleVolumeChanged, méthode (audiopolicy.h)
La méthode OnSimpleVolumeChanged avertit le client que le niveau de volume ou l’état de désactivation de la session audio a changé.
Syntaxe
HRESULT OnSimpleVolumeChanged(
[in] float NewVolume,
[in] BOOL NewMute,
[in] LPCGUID EventContext
);
Paramètres
[in] NewVolume
Nouveau niveau de volume pour la session audio. Ce paramètre est une valeur comprise entre 0.0 et 1.0, où 0.0 est silence et 1.0 est un volume complet (aucune atténuation).
[in] NewMute
Nouvel état de désactivation. Si la valeur EST TRUE, la désactivation est activée. Si la valeur est FALSE, la désactivation est désactivée.
[in] EventContext
Valeur du contexte d’événement. Il s’agit de la même valeur que celle que l’appelant a passée à ISimpleAudioVolume ::SetMasterVolume ou ISimpleAudioVolume ::SetMute dans l’appel qui a modifié le niveau de volume ou l’état de désactivation de la session. Pour plus d'informations, consultez la section Notes.
Valeur retournée
Si la méthode réussit, retourne S_OK. En cas d'échec, retourne un code d'erreur.
Remarques
Le gestionnaire de sessions appelle cette méthode chaque fois qu’un appel à la méthode ISimpleAudioVolume ::SetMasterVolume ou ISimpleAudioVolume ::SetMute modifie le niveau de volume ou l’état de désactivation de la session.
Le paramètre EventContext fournit un moyen pour un client de faire la distinction entre une modification de volume ou de mise en sourdine qu’il a initiée et une modification initiée par un autre client. Lors de l’appel de la méthode ISimpleAudioVolume ::SetMasterVolume ou ISimpleAudioVolume ::SetMute , un client transmet une valeur de paramètre EventContext que son implémentation de la méthode OnSimpleVolumeChanged peut reconnaître.
Pour obtenir un exemple de code qui implémente les méthodes dans l’interface IAudioSessionEvents , consultez Événements de session 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 | audiopolicy.h |