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