SP_DEVINSTALL

SP_DEVINSTALL_PARAMS

typedef struct _SP_DEVINSTALL_PARAMS {

DWORD cbSize;

DWORD Flags;

DWORD FlagsEx;

HWND hwndParent;

PSP_FILE_CALLBACK InstallMsgHandler;

PVOID InstallMsgHandlerContext;

HSPFILEQ FileQueue;

DWORD ClassInstallReserved;

DWORD Reserved;

TCHAR DriverPath[MAX_PATH];

} SP_DEVINSTALL_PARAMS, *PSP_DEVINSTALL_PARAMS;

SP_DEVINSTALL_PARAMS defines device install parameters associated with a particular device information element or globally with a device information set.

Members

cbSize

Contains the size, in bytes, of the SP_DEVINSTALL_PARAMS structure.

Flags

Flags that control installation and user interface functions. Some flags can be set prior to calling the device installation functions while others are set automatically during the processing of some functions. Flags can be a combination of the following values:

DI_SHOWOEM

Set to allow support for OEM disks.

DI_NOVCP

Set to disable creation of a new copy queue. Use the caller-supplied copy queue.

DI_DIDCOMPAT

Will be set if SetupDiBuildDriverInfoList has already built a list of compatible drivers for this device. If this list has already been built, it contains all the driver information and this flag is always set.

DI_DIDCLASS

Will be set if SetupDiBuildDriverInfoList has already built a list of class drivers for this device. If this list has already been built, it contains all the driver information and this flag is always set.

DI_NEEDRESTART

Will be set by SetupDiInstallDevice if the device requires that the machine be rebooted after device installation or a device state change.

DI_NEEDREBOOT

For Windows NT, this is the same as DI_NEEDRESTART.

DI_NOBROWSE

Set to disable browsing when the user is selecting an OEM disk path.

DI_MULTMFGS

Will be set by SetupDiBuildDriverInfoList if a class driver list contains drivers provided by multiple manufacturers.

DI_GENERALPAGE_ADDED

Set by a property page provider if a general properties page has been added to the device's property sheet.

DI_RESOURCEPAGE_ADDED

Set by a property page provider if a resource properties page has been added to the device's property sheet.

DI_PROPERTIES_CHANGE

Set if a device's properties have been changed and require an update of the installer's user interface.

DI_INF_IS_SORTED

Set to indicate that the sorting order from the INF file should be used.

DI_ENUMSINGLEINF

Set if SetupDiBuildDriverInfoList should only search the specified INF file.

DI_DONOTCALLCONFIGMG

Set if the Configuration Manager should not be called to modify the registry hardware tree during the execution of certain device installation functions (for example, SetupDiInstallDevice).

DI_INSTALLDISABLED

Set if the device should be installed in a disabled state by default.

DI_COMPAT_FROM_CLASS

Set to force SetupDiBuildDriverInfoList to build a device's list of compatible drivers from its class driver list instead of the INF file.

DI_CLASSINSTALLPARAMS

Set to use the Class Install parameters.

DI_NODI_DEFAULTACTION

Set if SetupDiCallClassInstaller should not perform any default action if the class installer returns ERR_DI_DO_DEFAULT or there is not a class installer.

DI_QUIETINSTALL

Set if the device installer functions should be as silent as possible and use default choices wherever possible.

DI_NOFILECOPY

Set if SetupDiInstallDevice should skip file copying.

DI_FORCECOPY

Set if SetupDiInstallDevice should always copy files, even if they are already present on the system.

DI_DRIVERPAGE_ADDED

Set by a property page provider if a driver properties page has been added to the device's property sheet.

DI_USECI_SELECTSTRINGS

Set if class installer-provided strings should be used during SetupDiSelectDevice.

DI_PROPS_NOCHANGEUSAGE

Set if there should be no Enable/Disable capability on the device's general property page.

DI_NOSELECTICONS

Set if small icons should not be used in select device dialogs.

DI_NOWRITE_IDS

Set if SetupDiInstallDevice should not write the device's hardware and compatible IDs to the registry.

FlagsEx

Flags that provide extended control over installation and user interface functions. Some flags can be set prior to calling the device installer functions while others are set automatically during the processing of some functions. Flags can be a combination of the following values:

DI_FLAGSEX_AUTOSELECTRANK0

Set if SetupDiSelectDevice should automatically select all rank 0 drivers.

DI_FLAGSEX_CI_FAILED

Is set internally if a class installer failed to load or start.

DI_FLAGSEX_DIDINFOLIST

A class driver list has been built.

DI_FLAGSEX_DIDCOMPATINFO

A compatible driver list has been built.

DI_FLAGSEX_FILTERCLASSES

If set, SetupDiBuildClassInfoList will check for class inclusion filters. This means that a device will not be included in the class list if its class is marked as NoInstallClass.

DI_FLAGSEX_SETFAILEDINSTALL

If set, the FAILEDINSTALL flag will be set when SetupDiInstallDevice installs a NULL driver.

DI_FLAGSEX_DEVICECHANGE

If set, any user interface that displays a list of devices will rebuild its list of devices after the device property sheet is closed.

DI_FLAGSEX_ALWAYSWRITEIDS

If set and the DI_NOWRITE_IDS flag is clear, always write hardware and compatible IDs to the registry.

DI_FLAGSEX_ALLOWEXCLUDEDDRVS

If set, SetupDiSelectDevice displays drivers that have the Exclude From Select state.

DI_FLAGSEX_USECLASSFORCOMPAT

Filter INF files on the device's class when building a list of compatible drivers. If a device's class is known, setting this flag can decrease the time required to build a list of compatible drivers.

DI_FLAGSEX_OLDINF_IN_CLASSLIST

Search legacy INF files when building a class driver list. This flag is valid for Windows NT only.

DI_FLAGSEX_NO_DRVREG_MODIFY

Do not process the AddReg and DelReg items for the device's software (driver) key.

hwndParent

Window handle that will own the user interface dialogs related to this device.

InstallMsgHandler

Callback used to handle events during file copying.

InstallMsgHandlerContext

Private data used by the InstallMsgHandler callback.

FileQueue

A handle to a caller-supplied file queue where file operations should be queued but not committed.

DriverPath

Specifies the path to this device's INF file. This is a non-empty string only if the driver was installed from an OEM INF file.