Énumération AudioSessionState (audiosessiontypes.h)

Article
02/26/2024

L’énumération AudioSessionState définit des constantes qui indiquent l’état actuel d’une session audio.

Syntax

typedef enum _AudioSessionState {
  AudioSessionStateInactive,
  AudioSessionStateActive,
  AudioSessionStateExpired
} AudioSessionState;

Constantes


`AudioSessionStateInactive` La session audio est inactive. (Il contient au moins un flux, mais aucun des flux de la session n’est en cours d’exécution.)
`AudioSessionStateActive` La session audio est active. (Au moins un des flux de la session est en cours d’exécution.)
`AudioSessionStateExpired` La session audio a expiré. (Il ne contient aucun flux.)

Remarques

Lorsqu’un client ouvre une session en affectant le premier flux à la session (en appelant la méthode IAudioClient ::Initialize ), l’état de session initial est inactif. L’état de session passe d’inactif à actif lorsqu’un flux de la session commence à s’exécuter (car le client a appelé la méthode IAudioClient ::Start ). La session passe d’active à inactive lorsque le client arrête le dernier flux en cours d’exécution dans la session (en appelant la méthode IAudioClient ::Stop ). L’état de session devient expiré lorsque le client détruit le dernier flux de la session en libérant toutes les références à l’objet stream.

Le programme de contrôle de volume système, Sndvol, affiche les contrôles de volume pour les sessions actives et inactives. Sndvol cesse d’afficher le contrôle de volume pour une session lorsque l’état de la session passe à expiration. Pour plus d’informations sur Sndvol, consultez Sessions audio.

Les méthodes IAudioSessionControl ::GetState et IAudioSessionEvents ::OnStateChanged utilisent les constantes définies dans l’énumération AudioSessionState .

Pour plus d’informations sur les états de session, consultez Sessions 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]
En-tête	audiosessiontypes.h