SetupDiEnumDeviceInfo 函数 （setupapi.h）

SetupDiEnumDeviceInfo 函数返回一个SP_DEVINFO_DATA结构，该结构指定设备信息集中的设备信息元素。

Syntax

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 to sizeof(SP_DEVINFO_DATA).

返回值

如果函数成功，则返回 TRUE 。 否则，它会返回 FALSE ，可以通过调用 GetLastError 来检索记录的错误。

注解

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

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

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

在记录 SetupDiGetClassDevsW 的页面上提供了 SetupDiEnumDeviceInfo 用法示例。

要求

另请参阅

SP_DEVINFO_DATA

SetupDiCreateDeviceInfo

SetupDiDeleteDeviceInfo

SetupDiEnumDeviceInterfaces

SetupDiOpenDeviceInfo