SetupDiCreateDeviceInfoList-Funktion (setupapi.h)
Die SetupDiCreateDeviceInfoList-Funktion erstellt einen leeren Geräteinformationssatz und ordnet die Gruppe optional einer Gerätesetupklasse und einem Fenster der obersten Ebene zu.
Syntax
WINSETUPAPI HDEVINFO SetupDiCreateDeviceInfoList(
[in, optional] const GUID *ClassGuid,
[in, optional] HWND hwndParent
);
Parameter
[in, optional] ClassGuid
Ein Zeiger auf die GUID der Gerätesetupklasse, die dem neu erstellten Geräteinformationssatz zugeordnet werden soll. Wenn dieser Parameter angegeben ist, können nur Geräte dieser Klasse in diesen Geräteinformationssatz eingeschlossen werden. Wenn dieser Parameter auf NULL festgelegt ist, ist der Geräteinformationssatz keiner bestimmten Gerätesetupklasse zugeordnet.
[in, optional] hwndParent
Ein Handle für das Fenster der obersten Ebene, das für jede Benutzeroberfläche verwendet werden soll, die sich auf nicht gerätespezifische Aktionen bezieht (z. B. ein Dialogfeld "Gerät auswählen", in dem die globale Klassentreiberliste verwendet wird). Dieses Handle ist optional und kann NULL sein. Wenn ein bestimmtes Fenster der obersten Ebene nicht erforderlich ist, legen Sie hwndParent auf NULL fest.
Rückgabewert
Die Funktion gibt bei erfolgreicher Ausführung ein Handle an einen leeren Geräteinformationssatz zurück. Andernfalls wird INVALID_HANDLE_VALUE zurückgegeben. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.
Hinweise
Der Aufrufer dieser Funktion muss die zurückgegebenen Geräteinformationen löschen, wenn sie nicht mehr benötigt werden, indem SetupDiDestroyDeviceInfoList aufgerufen wird.
Verwenden Sie SetupDiCreateDeviceInfoListEx, um eine Geräteinformationsliste für einen Remotecomputer zu erstellen.
Anforderungen
| Unterstützte Mindestversion (Client) | Verfügbar in Microsoft Windows 2000 und höheren Versionen von Windows. |
| Zielplattform | Desktop |
| Kopfzeile | setupapi.h (einschließlich Setupapi.h) |
| Bibliothek | Setupapi.lib |
| DLL | Setupapi.dll |
| APIs | ext-ms-win-setupapi-classinstallers-l1-1-1 (eingeführt in Windows 8.1) |