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

另请参阅

SetupDiAskForOEMDisk