Méthode IAudioSessionEvents ::OnStateChanged (audiopolicy.h)

La méthode OnStateChanged avertit le client que l’état de l’activité de flux de la session a changé.

Syntaxe

HRESULT OnStateChanged(
  [in] AudioSessionState NewState
);

Paramètres

[in] NewState

Nouvel état de session. La valeur de ce paramètre est l’une des valeurs d’énumération AudioSessionState suivantes :

AudioSessionStateActive

AudioSessionStateInactive

AudioSessionStateExpired

Valeur retournée

Si la méthode réussit, retourne S_OK. En cas d'échec, retourne un code d'erreur.

Remarques

Un client ne peut pas générer d’événement de changement d’état de session. Le système est toujours la source de ce type d’événement. Par conséquent, contrairement à d’autres méthodes IAudioSessionEvents , cette méthode ne fournit pas de paramètre de contexte.

Le système change l’état d’une session d’inactif à actif au moment où un client ouvre le premier flux de la session. Un client ouvre un flux en appelant la méthode IAudioClient ::Initialize . Le système change l’état de session d’actif à inactif au moment où un client ferme le dernier flux de la session. Le client qui libère la dernière référence à un objet IAudioClient ferme le flux associé à l’objet .

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

IAudioClient, interface

IAudioClient ::Initialize

IAudioSessionEvents, interface