SetupDiGetDeviceInstanceIdA-Funktion (setupapi.h)
Die SetupDiGetDeviceInstanceId Funktion ruft die Geräteinstanz-ID ab, die einem Geräteinformationselement zugeordnet ist.
Anmerkung
In Windows Vista und höheren Versionen von Windows verwendet das einheitliche Geräteeigenschaftenmodell den DEVPKEY_Device_InstanceIdEigenschaftenschlüssel, um den Geräteinstanzbezeichner darzustellen. Weitere Informationen finden Sie unter Abrufen eines Geräteinstanzbezeichners.
Syntax
WINSETUPAPI BOOL SetupDiGetDeviceInstanceIdA(
[in] HDEVINFO DeviceInfoSet,
[in] PSP_DEVINFO_DATA DeviceInfoData,
[out, optional] PSTR DeviceInstanceId,
[in] DWORD DeviceInstanceIdSize,
[out, optional] PDWORD RequiredSize
);
Parameter
[in] DeviceInfoSet
Ein Handle zum Geräteinformationssatz, das das Geräteinformationselement enthält, das das Gerät darstellt, für das eine Geräteinstanz-ID abgerufen werden soll.
[in] DeviceInfoData
Ein Zeiger auf eine SP_DEVINFO_DATA Struktur, die das Geräteinformationselement in DeviceInfoSet-angibt.
[out, optional] DeviceInstanceId
Ein Zeiger auf den Zeichenpuffer, der die NULL-beendete Geräteinstanz-ID für das angegebene Geräteinformationselement empfängt. Informationen zu Geräteinstanz-IDs finden Sie unter Device Identification Strings.
[in] DeviceInstanceIdSize
Die Größe des DeviceInstanceId- Puffers in Zeichen.
[out, optional] RequiredSize
Ein Zeiger auf die Variable, die die Anzahl der Zeichen empfängt, die zum Speichern der Geräteinstanz-ID erforderlich sind.
Rückgabewert
Die Funktion gibt TRUE- zurück, wenn sie erfolgreich ist. Andernfalls wird FALSE- zurückgegeben, und der protokollierte Fehler kann abgerufen werden, indem ein Aufruf an GetLastError-ausgeführt wird.
Bemerkungen
Anmerkung
Der Header setupapi.h definiert SetupDiGetDeviceInstanceId als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar in Microsoft Windows 2000 und höheren Versionen von Windows. |
| Zielplattform- | Desktop |
| Header- | setupapi.h (include Setupapi.h) |
| Library | Setupapi.lib |