Share via

IAudioSessionEvents ::OnSimpleVolumeChanged, méthode (audiopolicy.h)

  • Article

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

Voir aussi

IAudioSessionEvents Interface

ISimpleAudioVolume ::SetMasterVolume

ISimpleAudioVolume ::SetMute