setupDiGetSelectedDevice 函数 (setupapi.h)
SetupDiGetSelectedDevice 函数检索设备信息集中选定的设备信息元素。
语法
WINSETUPAPI BOOL SetupDiGetSelectedDevice(
[in] HDEVINFO DeviceInfoSet,
[out] PSP_DEVINFO_DATA DeviceInfoData
);
参数
[in] DeviceInfoSet
要检索所选 设备信息元素的设备信息集 的句柄。
[out] DeviceInfoData
指向 SP_DEVINFO_DATA 结构的指针,该结构接收有关 DeviceInfoSet 的所选设备信息元素的信息。 调用方必须设置 DeviceInfoData。cbSize 为 sizeof (SP_DEVINFO_DATA) 。 如果当前未选择设备,该函数将失败,并且对 GetLastError 的调用将返回ERROR_NO_DEVICE_SELECTED。
返回值
如果成功,函数将返回 TRUE 。 否则,它将返回 FALSE ,并且可以通过调用 GetLastError 来检索记录的错误。
注解
SetupDiGetSelectedDevice 通常由安装向导使用。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | 在 Microsoft Windows 2000 及更高版本的 Windows 中可用。 |
目标平台 | 桌面 |
标头 | setupapi.h (包括 Setupapi.h) |
Library | Setupapi.lib |
DLL | Setupapi.dll |