IAudioSessionManager2::GetSessionEnumerator-Methode (audiopolicy.h)

Die GetSessionEnumerator-Methode ruft einen Zeiger auf das Enumeratorobjekt der Audiositzung ab.

Syntax

HRESULT GetSessionEnumerator(
  [out] IAudioSessionEnumerator **SessionEnum
);

Parameter

[out] SessionEnum

Empfängt einen Zeiger auf die IAudioSessionEnumerator-Schnittstelle des Sitzungsenumeratorobjekts, mit dem der Client Audiositzungen auf dem Audiogerät auflisten kann. Mit dieser Methode erhält der Aufrufer einen gezählten Verweis auf die Schnittstelle. Der Aufrufer ist für die Freigabe der Schnittstelle verantwortlich, wenn sie nicht mehr benötigt wird, indem er die Release-Methode der Schnittstelle aufruft.

Rückgabewert

Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben.

Hinweise

Der Sitzungs-Manager verwaltet eine Sammlung von Audiositzungen, die auf dem Audiogerät aktiv sind, indem er die Audio-Engine abfragt. GetSessionEnumerator erstellt ein Sitzungssteuerelement für jede Sitzung in der Auflistung. Um einen Verweis auf die IAudioSessionControl-Schnittstelle der Sitzung in der enumerierten Auflistung abzurufen, muss die Anwendung IAudioSessionEnumerator::GetSession aufrufen. Ein Codebeispiel finden Sie unter IAudioSessionEnumerator-Schnittstelle.

Der Sitzungsenumerator ist möglicherweise nicht über die neuen Sitzungen informiert, die über IAudioSessionNotification gemeldet werden. Wenn sich eine Anwendung also ausschließlich auf den Sitzungsenumerator zum Abrufen aller Sitzungen für einen Audioendpunkt stützt, sind die Ergebnisse möglicherweise nicht korrekt. Um dies zu umgehen, sollte die Anwendung manuell eine Liste verwalten. Weitere Informationen finden Sie unter IAudioSessionEnumerator.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	audiopolicy.h

Weitere Informationen

IAudioSessionManager2