Share via

IAudioSessionControl2::GetSessionInstanceIdentifier-Methode (audiopolicy.h)

  • Artikel

Die GetSessionInstanceIdentifier-Methode ruft den Bezeichner der Audiositzung instance ab.

Syntax

HRESULT GetSessionInstanceIdentifier(
  [out] LPWSTR *pRetVal
);

Parameter

[out] pRetVal

Zeiger auf die Adresse einer mit NULL beendeten Breitzeichenzeichenfolge, die den Bezeichner einer bestimmten instance der Audiositzung 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 Windows SDK-Dokumentation.

Rückgabewert

Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Wenn ein Fehler auftritt, umfassen mögliche Rückgabecodes die in der folgenden Tabelle gezeigten Werte, 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 instance wird durch eine eindeutige Zeichenfolge identifiziert. Diese Zeichenfolge stellt eine bestimmte instance der Audiositzung dar und ist im Gegensatz zum Sitzungsbezeichner für alle Instanzen eindeutig. Wenn zwei Instanzen der Anwendung ausgeführt werden, verfügen diese über unterschiedliche Sitzungs-instance-IDs. Der von GetSessionInstanceIdentifier abgerufene Bezeichner unterscheidet sich vom Sitzungsbezeichner, der von allen Sitzungsinstanzen gemeinsam verwendet wird. Rufen Sie zum Abrufen des Sitzungsbezeichners IAudioSessionControl2::GetSessionIdentifier auf.

GetSessionInstanceIdentifier ü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 instance nicht gefunden wird, ruft diese Methode ihn von der Audio-Engine ab. Beispielcode zum Abrufen einer Sitzung instance Bezeichners finden Sie unter Abrufen von Duckingereignissen von einem Kommunikationsgerät.

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

Verwenden eines Kommunikationsgeräts