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 来检索记录的错误。

注解

对此函数的重复调用返回不同设备的设备信息元素。 可以重复调用此函数以获取有关设备信息集中所有设备的信息。

若要枚举设备信息元素,安装程序最初应调用 MemberIndex 参数设置为 0 的 SetupDiEnumDeviceInfo。 然后,安装程序应递增 MemberIndex 并调用 SetupDiEnumDeviceInfo ,直到函数失败 (没有其他值,并且对 GetLastError 的调用将返回 ERROR_NO_MORE_ITEMS) 。

调用 SetupDiEnumDeviceInterfaces 以获取设备 接口 元素的上下文结构, (与设备 信息 元素) 。

要求

   
最低受支持的客户端 在 Microsoft Windows 2000 及更高版本的 Windows 中可用。
目标平台 桌面
标头 setupapi.h (包括 Setupapi.h)
Library Setupapi.lib
DLL Setupapi.dll
API 集 windows 8 中引入的 ext-ms-win-setupapi-classinstallers-l1-1-0 ()

另请参阅

SP_DEVINFO_DATA

SetupDiCreateDeviceInfo

SetupDiDeleteDeviceInfo

SetupDiEnumDeviceInterfaces

SetupDiOpenDeviceInfo