共用方式為


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)

另請參閱

SetupDiCreateDeviceInfoListEx

SetupDiDestroyDeviceInfoList

SetupDiGetClassDevs

SetupDiGetDeviceInfoListClass