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 結構的指標,用以接收關於已枚舉裝置資訊元素的資訊。 呼叫者必須設定 DeviceInfoData。cbSize 為 sizeof(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 引入) |