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 |