IAudioSessionControl2::GetProcessId-Methode (audiopolicy.h)

  • Artikel

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
E_POINTER
 pRetVal ist NULL.
AUDCLNT_S_NO_SINGLE_PROCESS
 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:

#define AUDCLNT_S_NO_SINGLE_PROCESS AUDCLNT_SUCCESS (0x00d)
AUDCLNT_E_DEVICE_INVALIDATED
 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

Weitere Informationen

IAudioSessionControl2