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)

另請參閱

SP_DEVINFO_DATA

SetupDiCreateDeviceInfo

SetupDiDeleteDeviceInfo

SetupDiEnumDeviceInterfaces

SetupDiOpenDeviceInfo