SetupDiGetDeviceInstallParamsA 函数 (setupapi.h)
SetupDiGetDeviceInstallParams 函数检索设备信息集或特定设备信息元素的设备安装参数。
语法
WINSETUPAPI BOOL SetupDiGetDeviceInstallParamsA(
[in] HDEVINFO DeviceInfoSet,
[in, optional] PSP_DEVINFO_DATA DeviceInfoData,
[out] PSP_DEVINSTALL_PARAMS_A DeviceInstallParams
);
参数
[in] DeviceInfoSet
包含要检索的设备安装参数的设备 信息集 的句柄。
[in, optional] DeviceInfoData
指向 SP_DEVINFO_DATA 结构的指针,该结构指定 DeviceInfoSet 中的设备信息元素。 此参数是可选的,可以为 NULL。 如果指定此参数, SetupDiGetDeviceInstallParams 将检索指定设备的安装参数。 如果此参数为 NULL,则该函数将检索与 DeviceInfoSet 关联的全局设备安装参数。
[out] DeviceInstallParams
指向接收设备安装参数 的SP_DEVINSTALL_PARAMS 结构的指针。 DeviceInstallParams。在调用此函数之前,必须将 cbSize 设置为结构的大小(以字节为单位)。
返回值
如果成功,该函数将返回 TRUE 。 否则,它将返回 FALSE ,并且可以通过调用 GetLastError 来检索记录的错误。
注解
注意
setupapi.h 标头将 SetupDiGetDeviceInstallParams 定义为别名,该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将非特定编码别名的使用与非非特定编码的代码混合使用可能会导致不匹配,从而导致编译或运行时错误。 有关详细信息,请参阅 函数原型的约定。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | 在 Microsoft Windows 2000 及更高版本的 Windows 中可用。 |
目标平台 | 桌面 |
标头 | setupapi.h (包括 Setupapi.h) |
Library | Setupapi.lib |
另请参阅
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈