IAudioSessionManager::GetAudioSessionControl-Methode (audiopolicy.h)

Artikel
08/22/2023

Die GetAudioSessionControl-Methode ruft ein Audiositzungssteuerelement ab.

Syntax

HRESULT GetAudioSessionControl(
  [in]  LPCGUID              AudioSessionGuid,
  [in]  DWORD                StreamFlags,
  [out] IAudioSessionControl **SessionControl
);

Parameter

[in] AudioSessionGuid

Zeiger auf eine Sitzungs-GUID. Wenn die GUID keine sitzung identifiziert, die zuvor geöffnet wurde, öffnet der Aufruf eine neue, aber leere Sitzung. Das Sndvol-Programm zeigt kein Steuerelement auf Volumeebene für eine Sitzung an, es sei denn, es enthält einen oder mehrere aktive Streams. Wenn dieser Parameter NULL ist oder auf den Wert GUID_NULL verweist, weist die Methode den Stream der Standardsitzung zu.

[in] StreamFlags

Gibt die status der Flags für den Audiostream an.

[out] SessionControl

Zeiger auf eine Zeigervariable, in die die Methode einen Zeiger auf die IAudioSessionControl-Schnittstelle des Audiositzungssteuerungsobjekts schreibt. Der Aufrufer ist für das Freigeben der Schnittstelle verantwortlich, wenn sie nicht mehr benötigt wird, indem die Release-Methode der Schnittstelle aufgerufen wird. Wenn der Aufruf fehlschlägt, ist *SessionControlNULL.

Rückgabewert

Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Wenn ein Fehler auftritt, können mögliche Rückgabecodes die in der folgenden Tabelle gezeigten Werte umfassen, sind jedoch nicht darauf beschränkt.

Rückgabecode	Beschreibung
AUDCLNT_E_NOT_INITIALIZED	Der Audiostream wurde nicht erfolgreich initialisiert.
AUDCLNT_E_DEVICE_INVALIDATED	Das Audioendpunktgerät wurde getrennt, oder die Audiohardware oder die zugehörigen Hardwareressourcen wurden neu konfiguriert, deaktiviert, entfernt oder anderweitig für die Verwendung nicht verfügbar gemacht.
AUDCLNT_E_SERVICE_NOT_RUNNING	Der Windows-Audiodienst wird nicht ausgeführt.
E_POINTER	Der Parameter SessionControl ist NULL.
E_MEMORY	Nicht genügend Arbeitsspeicher.

Hinweise

Ein Codebeispiel, das diese Methode aufruft, finden Sie unter Audioereignisse für Legacy-Audioanwendungen.

Anforderungen


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

Weitere Informationen

IAudioSessionControl-Schnittstelle

IAudioSessionManager-Schnittstelle

Share via