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
Class co-installer |
Can handle |
Device co-installer |
Can handle |
Class installer |
Can handle |
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
Version |
Supported in Microsoft Windows 2000 and later versions of Windows. |
Header |
Setupapi.h (include Setupapi.h) |