IAudioSessionControl2::GetSessionInstanceIdentifier-Methode (audiopolicy.h)
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 |
|---|---|
|
pRetVal ist NULL. |
|
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 |