AudioSessionState-Enumeration (audiosessiontypes.h)

Artikel
02/23/2024

Die AudioSessionState-Enumeration definiert Konstanten, die den aktuellen Zustand einer Audiositzung angeben.

Syntax

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

Konstanten


`AudioSessionStateInactive` Die Audiositzung ist inaktiv. (Es enthält mindestens einen Stream, aber keiner der Streams in der Sitzung wird derzeit ausgeführt.)
`AudioSessionStateActive` Die Audiositzung ist aktiv. (Mindestens einer der Streams in der Sitzung wird ausgeführt.)
`AudioSessionStateExpired` Die Audiositzung ist abgelaufen. (Es enthält keine Streams.)

Hinweise

Wenn ein Client eine Sitzung öffnet, indem er der Sitzung den ersten Stream zuweist (durch Aufrufen der IAudioClient::Initialize-Methode ), ist der anfängliche Sitzungszustand inaktiv. Der Sitzungsstatus ändert sich von inaktiv zu aktiv, wenn ein Stream in der Sitzung ausgeführt wird (da der Client die IAudioClient::Start-Methode aufgerufen hat). Die Sitzung wechselt von aktiv zu inaktiv, wenn der Client den letzten ausgeführten Stream in der Sitzung beendet (durch Aufrufen der IAudioClient::Stop-Methode ). Der Sitzungsstatus ändert sich in abgelaufen, wenn der Client den letzten Stream in der Sitzung zerstört, indem alle Verweise auf das Streamobjekt freigegeben werden.

Das Systemvolumesteuerungsprogramm Sndvol zeigt Lautstärkesteuerungen sowohl für aktive als auch für inaktive Sitzungen an. Sndvol zeigt die Lautstärkesteuerung für eine Sitzung nicht mehr an, wenn sich der Sitzungsstatus in abgelaufen ändert. Weitere Informationen zu Sndvol finden Sie unter Audiositzungen.

Die Methoden IAudioSessionControl::GetState und IAudioSessionEvents::OnStateChanged verwenden die in der AudioSessionState-Enumeration definierten Konstanten.

Weitere Informationen zu Sitzungszuständen finden Sie unter Audiositzungen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [Desktop-Apps \| UWP-Apps]
Kopfzeile	audiosessiontypes.h