IAudioSessionManager::GetAudioSessionControl-Methode (audiopolicy.h)

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