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 |
|---|---|
|
Zeiger ppwstrDeviceId ist NULL. |
|
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 |