SetupDiCreateDeviceInfoList 函式 (setupapi.h)

SetupDiCreateDeviceInfoList函式會建立空的裝置資訊集，並選擇性地將集合與裝置設定類別和最上層視窗產生關聯。

語法

WINSETUPAPI HDEVINFO SetupDiCreateDeviceInfoList(
  [in, optional] const GUID *ClassGuid,
  [in, optional] HWND       hwndParent
);

[in, optional] ClassGuid

要與新建立之裝置資訊集建立關聯的裝置安裝類別 GUID 指標。如果指定此參數，此類別的裝置只能包含在此裝置資訊集中。如果此參數設定為 Null，則裝置資訊集不會與特定裝置設定類別相關聯。

[in, optional] hwndParent

最上層視窗的控制碼，用於與非裝置特定動作相關的任何使用者介面， (例如使用全域類別驅動程式清單的選取裝置對話方塊) 。此控制碼是選擇性的，可以是 Null。如果不需要特定的最上層視窗，請將 hwndParent 設定為 Null。

函式會在成功時，傳回空裝置資訊集的控制碼。否則，它會傳回 INVALID_HANDLE_VALUE。若要取得擴充的錯誤資訊，請呼叫 GetLastError。

呼叫 SetupDiDestroyDeviceInfoList時，此函式的呼叫端必須刪除已傳回的裝置資訊集。

若要建立遠端電腦的裝置資訊清單，請使用 SetupDiCreateDeviceInfoListEx。


最低支援的用戶端	可在 Microsoft Windows 2000 和更新版本的 Windows 中使用。
目標平台	桌上型
標頭	setupapi.h (包括 Setupapi.h)
程式庫	Setupapi.lib
Dll	Setupapi.dll
API 集合	ext-ms-win-setupapi-classinstallers-l1-1-1 (于 Windows 8.1)