Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 |