共用方式為


SetupDiEnumDeviceInfo 函式 (setupapi.h)

SetupDiEnumDeviceInfo 函式回傳一個 SP_DEVINFO_DATA 結構,指定裝置資訊集中的裝置資訊元素。

語法

WINSETUPAPI BOOL SetupDiEnumDeviceInfo(
  [in]  HDEVINFO         DeviceInfoSet,
  [in]  DWORD            MemberIndex,
  [out] PSP_DEVINFO_DATA DeviceInfoData
);

參數

[in] DeviceInfoSet

裝置 資訊集 的一個句柄,用來回傳一個代表裝置資訊元素的 SP_DEVINFO_DATA 結構。

[in] MemberIndex

一個以零為基礎的裝置資訊元素索引,需檢索。

[out] DeviceInfoData

一個指向 SP_DEVINFO_DATA 結構的指標,用以接收關於已枚舉裝置資訊元素的資訊。 呼叫者必須設定 DeviceInfoDatacbSizesizeof(SP_DEVINFO_DATA)

返回值

若函數成功,則回傳 TRUE 。 否則,系統會回傳 FALSE ,並可透過呼叫 GetLastError 取得已記錄的錯誤。

備註

重複呼叫此函式會回傳不同裝置的裝置資訊元素。 此函式可反覆呼叫,以取得裝置資訊集中所有裝置的資訊。

要列舉裝置資訊元素,安裝程式應先呼叫 SetupDiEnumDeviceInfo ,並將 MemberIndex 參數設為 0。 安裝程式應逐步遞增 MemberIndex ,並呼叫 SetupDiEnumDeviceInfo ,直到沒有其他值(函式失敗,呼叫 GetLastError 回傳 ERROR_NO_MORE_ITEMS)。

呼叫 SetupDiEnumDeviceInterfaces 以取得裝置 介面 元素(相較於裝置 資訊 元素)的上下文結構。

SetupDiEnumDeviceInfo 的使用範例可見於 SetupDiGetClassDevsW 文件頁面。

需求

Requirement 價值觀
最低支援的用戶端 適用於 Microsoft Windows 2000 和更新版本的 Windows。
目標平臺 桌面
Header setupapi.h(包含 Setupapi.h)
Library Setupapi.lib
DLL Setupapi.dll
API 集 ext-ms-win-setupapi-classinstallers-l1-1-0(於 Windows 8 引入)

另請參閱

SP_DEVINFO_DATA

SetupDiCreateDeviceInfo

SetupDiDeleteDeviceInfo

SetupDiEnumDeviceInterfaces

SetupDiOpenDeviceInfo