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 |