IAudioSessionControl2::GetSessionIdentifier-Methode (audiopolicy.h)

  • Artikel

Die GetSessionIdentifier-Methode ruft den Audiositzungsbezeichner ab.

Syntax

HRESULT GetSessionIdentifier(
  [out] LPWSTR *pRetVal
);

Parameter

[out] pRetVal

Zeiger auf die Adresse einer MIT NULL beendeten breitzeichenigen Zeichenfolge, die den Audiositzungsbezeichner empfängt. Die Zeichenfolge wird von dieser Methode zugeordnet und muss vom Aufrufer durch Aufrufen von CoTaskMemFree freigegeben werden. Informationen zu CoTaskMemFree finden Sie in der Dokumentation zum Windows SDK.

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ückgabewert Beschreibung
E_POINTER
 pRetVal ist NULL.
AUDCLNT_E_DEVICE_INVALIDATED
 Die Audiositzung wird auf dem Standardaudiogerät getrennt.

Hinweise

Jede Audiositzung wird durch eine Bezeichnerzeichenfolge identifiziert. Diese Sitzungsbezeichnerzeichenfolge ist nicht für alle Instanzen eindeutig. Wenn zwei Instanzen der Anwendung ausgeführt werden, verfügen beide Instanzen über denselben Sitzungsbezeichner. Der von GetSessionIdentifier abgerufene Bezeichner unterscheidet sich vom Sitzungsbezeichner instance, der für alle Sitzungen eindeutig ist. Um den Sitzungsbezeichner instance abzurufen, rufen Sie IAudioSessionControl2::GetSessionInstanceIdentifier auf.

GetSessionIdentifier überprüft, ob die Sitzung auf dem Standardgerät getrennt wurde. Es ruft die Bezeichnerzeichenfolge ab, die vom Audioclient für das Gerät zwischengespeichert wird. Wenn der Sitzungsbezeichner nicht gefunden wird, ruft diese Methode ihn von der Audio-Engine ab.

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

IAudioSessionControl2