SetupDiEnumDeviceInfo-Funktion (setupapi.h)
Die SetupDiEnumDeviceInfo-Funktion gibt eine SP_DEVINFO_DATA-Struktur zurück, die ein Geräteinformationselement in einem Geräteinformationssatz angibt.
Syntax
WINSETUPAPI BOOL SetupDiEnumDeviceInfo(
[in] HDEVINFO DeviceInfoSet,
[in] DWORD MemberIndex,
[out] PSP_DEVINFO_DATA DeviceInfoData
);
Parameter
[in] DeviceInfoSet
Ein Handle für den Geräteinformationssatz , für den eine SP_DEVINFO_DATA-Struktur zurückgegeben werden soll, die ein Geräteinformationselement darstellt.
[in] MemberIndex
Ein nullbasierter Index des abzurufenden Geräteinformationselements.
[out] DeviceInfoData
Ein Zeiger auf eine SP_DEVINFO_DATA-Struktur zum Empfangen von Informationen zu einem aufgezählten Geräteinformationselement. Der Aufrufer muss DeviceInfoData festlegen. cbSize in sizeof(SP_DEVINFO_DATA).
Rückgabewert
Die Funktion gibt TRUE zurück, wenn sie erfolgreich ist. Andernfalls wird FALSE zurückgegeben, und der protokollierte Fehler kann mit einem Aufruf von GetLastError abgerufen werden.
Hinweise
Wiederholte Aufrufe dieser Funktion geben ein Geräteinformationselement für ein anderes Gerät zurück. Diese Funktion kann wiederholt aufgerufen werden, um Informationen zu allen Geräten im Geräteinformationssatz abzurufen.
Um Geräteinformationselemente aufzulisten, sollte ein Installationsprogramm zunächst SetupDiEnumDeviceInfo aufrufen, wobei der MemberIndex-Parameter auf 0 festgelegt ist. Das Installationsprogramm sollte dann MemberIndex erhöhen und SetupDiEnumDeviceInfo aufrufen, bis keine weiteren Werte vorhanden sind (die Funktion schlägt fehl, und ein Aufruf von GetLastError gibt ERROR_NO_MORE_ITEMS zurück).
Rufen Sie SetupDiEnumDeviceInterfaces auf, um eine Kontextstruktur für ein Geräteschnittstellenelement (im Vergleich zu einem Geräteinformationselement ) abzurufen.
Anforderungen
| Unterstützte Mindestversion (Client) | Verfügbar in Microsoft Windows 2000 und höheren Versionen von Windows. |
| Zielplattform | Desktop |
| Kopfzeile | setupapi.h (schließen Sie Setupapi.h ein) |
| Bibliothek | Setupapi.lib |
| DLL | Setupapi.dll |
| APIs | ext-ms-win-setupapi-classinstallers-l1-1-0 (eingeführt in Windows 8) |