SetupDiCreateDeviceInfoList-Funktion (setupapi.h)

  • Artikel

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)

Weitere Informationen

SetupDiCreateDeviceInfoListEx

SetupDiDestroyDeviceInfoList

SetupDiGetClassDevs

SetupDiGetDeviceInfoListClass