Export (0) Print
Expand All
Expand Minimize

SetupDiGetDeviceInstallParams function

The SetupDiGetDeviceInstallParams function retrieves device installation parameters for a device information set or a particular device information element.

Syntax


BOOL SetupDiGetDeviceInstallParams(
  _In_      HDEVINFO DeviceInfoSet,
  _In_opt_  PSP_DEVINFO_DATA DeviceInfoData,
  _Out_     PSP_DEVINSTALL_PARAMS DeviceInstallParams
);

Parameters

DeviceInfoSet [in]

A handle to the device information set that contains the device installation parameters to retrieve.

DeviceInfoData [in, optional]

A pointer to an SP_DEVINFO_DATA structure that specifies the device information element in DeviceInfoSet. This parameter is optional and can be NULL. If this parameter is specified, SetupDiGetDeviceInstallParams retrieves the installation parameters for the specified device. If this parameter is NULL, the function retrieves the global device installation parameters that are associated with DeviceInfoSet.

DeviceInstallParams [out]

A pointer to an SP_DEVINSTALL_PARAMS structure that receives the device install parameters. DeviceInstallParams.cbSize must be set to the size, in bytes, of the structure before calling this function.

Return value

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

Requirements

Version

Available in Microsoft Windows 2000 and later versions of Windows.

Header

Setupapi.h (include Setupapi.h)

Library

Setupapi.lib

See also

SetupDiSetDeviceInstallParams
SP_DEVINFO_DATA
SP_DEVINSTALL_PARAMS

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft