SetupDiSelectOEMDrv 函数 (setupapi.h)
SetupDiSelectOEMDrv 函数为使用用户提供的 OEM 路径的设备信息集或特定设备信息元素选择驱动程序。
语法
WINSETUPAPI BOOL SetupDiSelectOEMDrv(
[in, optional] HWND hwndParent,
[in] HDEVINFO DeviceInfoSet,
[in, out] PSP_DEVINFO_DATA DeviceInfoData
);
参数
[in, optional] hwndParent
窗口句柄,它将是处理此函数期间创建的任何对话框的父级。 此参数可用于替代指定设备信息集或元素的安装参数块中的 hwndParent 字段。
[in] DeviceInfoSet
要为其选择驱动程序 的设备信息集 的句柄。
[in, out] DeviceInfoData
指向 SP_DEVINFO_DATA 结构的指针,该结构指定 DeviceInfoSet 中的设备信息元素。 此参数是可选的,可以为 NULL。 如果指定此参数, SetupDiSelectOEMDrv 会将所选驱动程序与指定的设备相关联。 如果此参数为 NULL, SetupDiSelectOEMDrv 会将所选驱动程序与 DeviceInfoSet 的全局类驱动程序列表相关联。
返回值
如果成功,函数将返回 TRUE 。 否则,它将返回 FALSE ,并且可以通过调用 GetLastError 来检索记录的错误。
注解
SetupDiSelectOEMDrv 主要用于为本地计算机上的设备选择 OEM 驱动程序,然后再在该计算机上安装该设备。 尽管如果设备信息集用于远程计算机, SetupDiSelectOEMDrv 不会失败,但结果是有限的,因为设备信息集随后无法与不支持远程计算机上的操作的 DIF_Xxx 安装请求或 SetupDiXxx 函数一起使用。 具体而言,设备信息集不能用作DIF_INSTALLDEVICE安装请求的输入,以在远程计算机上安装设备。
SetupDiSelectOEMDrv 提示用户输入 OEM 路径,然后调用类安装程序以从 OEM 路径中选择驱动程序。
要求
最低受支持的客户端 | 在 Microsoft Windows 2000 及更高版本的 Windows 中可用。 |
目标平台 | 桌面 |
标头 | setupapi.h (包括 Setupapi.h) |
Library | Setupapi.lib |
DLL | Setupapi.dll |