Enumerazione AudioSessionState (audiosessiontypes.h)

Articolo
03/11/2023

L'enumerazione AudioSessionState definisce costanti che indicano lo stato corrente di una sessione audio.

Sintassi

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

Costanti


`AudioSessionStateInactive` La sessione audio è inattiva. Contiene almeno un flusso, ma nessuno dei flussi nella sessione è attualmente in esecuzione.
`AudioSessionStateActive` La sessione audio è attiva. (Almeno uno dei flussi della sessione è in esecuzione).
`AudioSessionStateExpired` La sessione audio è scaduta. (Non contiene flussi).

Commenti

Quando un client apre una sessione assegnando il primo flusso alla sessione (chiamando il metodo IAudioClient::Initialize ), lo stato della sessione iniziale è inattivo. Lo stato della sessione cambia da inattivo a attivo quando inizia l'esecuzione di un flusso nella sessione, perché il client ha chiamato il metodo IAudioClient::Start . La sessione cambia da attiva a inattiva quando il client arresta l'ultimo flusso in esecuzione nella sessione (chiamando il metodo IAudioClient::Stop ). Lo stato della sessione viene modificato in scadenza quando il client elimina l'ultimo flusso nella sessione rilasciando tutti i riferimenti all'oggetto stream.

Il programma di controllo del volume di sistema, Sndvol, visualizza i controlli volume per sessioni attive e inattive. Sndvol smette di visualizzare il controllo volume per una sessione quando lo stato della sessione viene modificato in scadenza. Per altre informazioni su Sndvol, vedere Sessioni audio.

I metodi IAudioSessionControl::GetState e IAudioSessionEvents::OnStateChanged usano le costanti definite nell'enumerazione AudioSessionState .

Per altre informazioni sugli stati della sessione, vedere Sessioni audio.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [app desktop \| App UWP]
Server minimo supportato	Windows Server 2008 [app desktop \| App UWP]
Intestazione	audiosessiontypes.h