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 来检索记录的错误。
注解
对此函数的重复调用返回不同设备的设备信息元素。 可以重复调用此函数以获取有关设备信息集中所有设备的信息。
若要枚举设备信息元素,安装程序最初应调用 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 () |