Edit

SetupDiSelectOEMDrv function (setupapi.h)

  • Article

The SetupDiSelectOEMDrv function selects a driver for a device information set or a particular device information element that uses an OEM path supplied by the user.

Syntax

WINSETUPAPI BOOL SetupDiSelectOEMDrv(
  [in, optional] HWND             hwndParent,
  [in]           HDEVINFO         DeviceInfoSet,
  [in, out]      PSP_DEVINFO_DATA DeviceInfoData
);

Parameters

[in, optional] hwndParent

A window handle that will be the parent of any dialogs created during the processing of this function. This parameter can be used to override the hwndParent field in the installation parameters block of the specified device information set or element.

[in] DeviceInfoSet

A handle to the device information set for which to select a driver.

[in, out] DeviceInfoData

A pointer to an SP_DEVINFO_DATA structure that specifies a device information element in DeviceInfoSet. This parameter is optional and can be NULL. If this parameter is specified, SetupDiSelectOEMDrv associates the selected driver with the specified device. If this parameter is NULL, SetupDiSelectOEMDrv associates the selected driver with the global class driver list for DeviceInfoSet.

Return value

The function returns TRUE if it is successful. Otherwise, it returns FALSE and the logged error can be retrieved by a call to GetLastError.

Remarks

SetupDiSelectOEMDrv is primarily designed to select an OEM driver for a device on a local computer before installing the device on that computer. Although SetupDiSelectOEMDrv will not fail if the device information set is for a remote computer, the result is of limited use because the device information set cannot subsequently be used with DIF_Xxx installation requests or SetupDiXxx functions that do not support operations on a remote computer. In particular, the device information set cannot be used as input with a DIF_INSTALLDEVICE installation request to install a device on a remote computer.

SetupDiSelectOEMDrv prompts the user for the OEM path and then calls the class installer to select a driver from the OEM path.

Requirements

Requirement Value
Minimum supported client Available in Microsoft Windows 2000 and later versions of Windows.
Target Platform Desktop
Header setupapi.h (include Setupapi.h)
Library Setupapi.lib
DLL Setupapi.dll

See also

SetupDiAskForOEMDisk