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

另请参阅

SP_DEVINFO_DATA

SetupDiSetSelectedDevice