IDeviceTopology::GetDeviceId-Methode (devicetopology.h)

Die GetDeviceId-Methode ruft den Gerätebezeichner des Geräts ab, das durch das device-topology-Objekt dargestellt wird.

Syntax

HRESULT GetDeviceId(
  [out] LPWSTR *ppwstrDeviceId
);

Parameter

[out] ppwstrDeviceId

Zeiger auf eine Zeigervariable, in die die Methode die Adresse einer mit NULL beendeten Breitzeichenzeichenfolge schreibt, die den Gerätebezeichner enthält. Die -Methode ordnet den Speicher für die Zeichenfolge zu. Der Aufrufer ist dafür verantwortlich, den Speicher frei zu geben, wenn er nicht mehr benötigt wird, indem er die CoTaskMemFree-Funktion aufruft. Wenn der GetDeviceId-Aufruf fehlschlägt, ist *ppwstrDeviceIdNULL. 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ückgabecode	Beschreibung
D_POINTER	Zeiger ppwstrDeviceId ist NULL.
E_OUTOFMEMORY	Nicht genügend Arbeitsspeicher.

Hinweise

Der von dieser Methode abgerufene Gerätebezeichner kann als Eingabeparameter für die IMMDeviceEnumerator::GetDevice-Methode verwendet werden.

Ein Codebeispiel, das die GetDeviceId-Methode verwendet, finden Sie unter Verwenden der IKsControl-Schnittstelle für den Zugriff auf Audioeigenschaften.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	devicetopology.h

Weitere Informationen

IDeviceTopology-Schnittstelle

IMMDeviceEnumerator::GetDevice