DIF_NEWDEVICEWIZARD_FINISHINSTALL

A DIF_NEWDEVICEWIZARD_FINISHINSTALL request allows an installer to supply finish-install wizard pages that Windows displays to the user after a device is installed but before Windows displays the standard finish page. Windows sends this request when it installs Plug and Play (PnP) devices and when an administrator uses the Add Hardware Wizard to install non-PnP devices.

When Sent

After Windows installs a device (on successful completion of DIF_INSTALLDEVICE processing), but before it displays the Finish wizard page.

Who Handles

Installer Input

DeviceInfoSet
A handle to the device information set that contains the device.

DeviceInfoData
A pointer to an SP_DEVINFO_DATA structure that identifies the device in the device information set.

Device Installation Parameters
There are device installation parameters (SP_DEVINSTALL_PARAMS) associated with the DeviceInfoData.

Class Installation Parameters
An SP_NEWDEVICEWIZARD_DATA structure is associated with the DeviceInfoData.

Installer Output

Device Installation Parameters
An installer can modify the flags in the device installation parameters.

Class Installation Parameters
An installer can modify the SP_NEWDEVICEWIZARD_DATA structure to supply finish-install wizard pages.

Installer Return Value

If a co-installer does not handle this DIF request, the co-installer returns NO_ERROR from its preprocessing pass. If a co-installer handles this request, the co-installer can return NO_ERROR, ERROR_DI_POSTPROCESSING_REQUIRED, or a Win32 error code.

A class installer returns NO_ERROR if the installer successfully supplies pages. Otherwise, a class installer returns ERROR_DI_DO_DEFAULT or a Win32 error code.

Default DIF Code Handler

None

Installer Operation

For more information about DIF codes, see Handling DIF Codes.

Requirements

See also

DIF_FINISHINSTALL_ACTION

DIF_INSTALLDEVICE

SetupDiChangeState

SP_DEVINFO_DATA

SP_DEVINSTALL_PARAMS

SP_NEWDEVICEWIZARD_DATA