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) |