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

Class co-installer

Can handle

Device co-installer

Can handle

Class installer

Can handle

Installer Input

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

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


Installer Operation

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



Supported in Microsoft Windows 2000 and later versions of Windows.


Setupapi.h (include Setupapi.h)

See also