IAudioSessionControl2::GetProcessId-Methode (audiopolicy.h)
Die GetProcessId-Methode ruft den Prozessbezeichner der Audiositzung ab.
Syntax
HRESULT GetProcessId(
[out] DWORD *pRetVal
);
Parameter
[out] pRetVal
Zeiger auf eine DWORD-Variable , die den Prozessbezeichner der Audiositzung empfängt.
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 Sitzung umfasst mehrere Prozesse. In diesem Fall empfängt pRetVal den anfänglichen Bezeichner des Prozesses, der die Sitzung erstellt hat. Um diesen Wert zu verwenden, schließen Sie die folgende Definition ein:
|
|
Die Audiositzung wird auf dem Standardaudiogerät getrennt. |
Hinweise
Diese Methode überschreibt den Wert, der von der Anwendung in pRetVal übergeben wurde.
GetProcessId überprüft, ob die Audiositzung auf dem Standardgerät getrennt wurde oder ob die Sitzung zu einem anderen Stream gewechselt wurde. Im Falle eines Streamwechsels überträgt diese Methode Zustandsinformationen für den neuen Stream an die Sitzung. Zustandsinformationen umfassen Volumesteuerelemente, Metadateninformationen (Anzeigename, Symbolpfad) und den Eigenschaftenspeicher der Sitzung.
Anforderungen
| 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 |