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 結構的指標。 呼叫端必須設定 DeviceInfoData。cbSize 為 sizeof(SP_DEVINFO_DATA)
。
傳回值
如果函式成功,函式會傳回 TRUE 。 否則,它會傳回 FALSE ,而且可以透過呼叫 GetLastError來擷取記錄的錯誤。
備註
對這個函式的重複呼叫會傳回不同裝置的裝置資訊元素。 您可以重複呼叫此函式,以取得裝置資訊集中所有裝置的相關資訊。
若要列舉裝置資訊元素,安裝程式一開始應該呼叫 SetupDiEnumDeviceInfo ,並將 MemberIndex 參數設定為 0。 然後安裝程式應該遞增 MemberIndex 並呼叫 SetupDiEnumDeviceInfo ,直到函式沒有其他值 (失敗,而且 GetLastError 的呼叫會傳回 ERROR_NO_MORE_ITEMS) 。
呼叫 SetupDiEnumDeviceInterfaces 以取得裝置 介面 元素的內容結構, (與裝置 資訊 元素) 。
規格需求
最低支援的用戶端 | 可在 Microsoft Windows 2000 和更新版本的 Windows 中使用。 |
目標平台 | 桌上型 |
標頭 | setupapi.h (包括 Setupapi.h) |
程式庫 | Setupapi.lib |
Dll | Setupapi.dll |
API 集合 | ext-ms-win-setupapi-classinstallers-l1-1-0 (在 Windows 8) |