IAudioSessionEvents::OnStateChanged-Methode (audiopolicy.h)

Die OnStateChanged-Methode benachrichtigt den Client, dass sich der Streamaktivitätsstatus der Sitzung geändert hat.

Syntax

HRESULT OnStateChanged(
  [in] AudioSessionState NewState
);

Parameter

[in] NewState

Der neue Sitzungsstatus. Der Wert dieses Parameters ist einer der folgenden AudioSessionState-Enumerationswerte :

AudioSessionStateActive

AudioSessionStateInactive

AudioSessionStateExpired

Rückgabewert

Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Bei einem Fehler wird ein Fehlercode zurückgegeben.

Hinweise

Ein Client kann kein Sitzungszustandsänderungsereignis generieren. Das System ist immer die Quelle dieses Ereignistyps. Daher stellt diese Methode im Gegensatz zu einigen anderen IAudioSessionEvents-Methoden keinen Kontextparameter bereit.

Das System ändert den Zustand einer Sitzung von inaktiv in aktiv, wenn ein Client den ersten Stream in der Sitzung öffnet. Ein Client öffnet einen Stream, indem er die IAudioClient::Initialize-Methode aufruft . Das System ändert den Sitzungsstatus von aktiv in inaktiv, wenn ein Client den letzten Stream in der Sitzung schließt. Der Client, der den letzten Verweis auf ein IAudioClient-Objekt freigibt, schließt den Stream, der dem -Objekt zugeordnet ist.

Ein Codebeispiel, das die Methoden in der IAudioSessionEvents-Schnittstelle implementiert, finden Sie unter Audiositzungsereignisse.

Anforderungen

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

Weitere Informationen

IAudioClient-Schnittstelle

IAudioClient::Initialize

IAudioSessionEvents-Schnittstelle