typedef struct _SP_INSTALLWIZARD_DATA {
SP_CLASSINSTALL_HEADER ClassInstallHeader;
DWORD Flags;
HPROPSHEETPAGE DynamicPages[MAX_INSTALLWIZARD_DYNAPAGES];
DWORD NumDynamicPages;
DWORD DynamicPageFlags;
DWORD PrivateFlags;
LPARAM PrivateData;
HWND hwndWizardDlg;
} SP_INSTALLWIZARD_DATA, *PSP_INSTALLWIZARD_DATA;
SP_INSTALLWIZARD_DATA is used by class installers to extend the operation of the hardware installation wizard by adding custom pages. It is used for both the DIF_INSTALLWIZARD and DIF_DESTROYWIZARDDATA install functions.
Members
ClassInstallHeader
Defines the class installation request for the install parameter structure.
Flags
These are internal flags used by the device installer.
DynamicPages
Contains an array of property sheet page handles. The class installer can use this array to create custom wizard pages and insert their handles into this array.
NumDynamicPages
The number of pages inserted into the DynamicPages array.
DynamicPageFlags
Flags that control the behavior of the installation wizard when dynamic pages have been added. Can be a combination of the following values:
DYNAWIZ_FLAG_PAGESADDED
Set by the hardware installation wizard if the class installer adds custom pages.
DYNAWIZ_FLAG_INSTALLDET_NEXT
If set, the hardware installation wizard allows the user to go forward from the Detected Devices page; otherwise, Finish is the default option for the Detected Devices page.
DYNAWIZ_FLAG_INSTALLDET_PREV
If set, the hardware installation wizard allows the user to go back from the Detected Devices page.
DYNAWIZ_FLAG_ANALYZE_HANDLECONFLICT
Set this flag if you jump to the Analyze page of the hardware installation wizard and want it to handle conflicts. Control will not be returned to the class installer if this flag is set and a conflict occurs.
The following flags are resource IDs for pre-defined pages of the hardware installation wizard:
IDD_DYNAWIZ_FIRSTPAGE
Resource ID for the first page that the hardware installation wizard will go to after adding the custom class installer pages.
IDD_DYNAWIZ_SELECT_PREVPAGE
Resource ID for the page that the Select Device page will go back to.
IDD_DYNAWIZ_SELECT_NEXTPAGE
Resource ID for the page that the Select Device page will go forward to.
IDD_DYNAWIZ_ANALYZE_PREVPAGE
Resource ID for the page that the Analyze dialog will go back to. This page is only used in the event that there is a problem and the user clicks on the Back button from the Analyze page.
IDD_DYNAWIZ_ANALYZE_NEXTPAGE
Resource ID for the page that the Analyze dialog will go to if it continues forward.
IDD_DYNAWIZ_INSTALLDETECTED_PREVPAGE
Resource ID for the page that the Install Detected Devices page will go back to.
IDD_DYNAWIZ_INSTALLDETECTED_NEXTPAGE
Resource ID for the page that the Install Detected Devices page will go forward to.
IDD_DYNAWIZ_INSTALLDETECTED_NODEVS
Resource ID for the page that the Install Detected Devices page will go to in the event that no devices are detected.
IDD_DYNAWIZ_SELECTDEV_PAGE
Resource ID of the hardware installation wizard's Select Device page.
IDD_DYNAWIZ_ANALYZEDEV_PAGE
Resource ID of the hardware installation wizard's Analyze page.
IDD_DYNAWIZ_INSTALLDETECTEDDEVS_PAGE
Resource ID of the hardware installation wizard's Install Detected Devices page.
IDD_DYNAWIZ_SELECTCLASS_PAGE
Resource ID of the hardware installation wizard's Select Class page.
PrivateFlags
Flags that can be defined and used by the class installer.
PrivateData
Pointer to private data defined and set by the class installer.
hwndWizardDlg
Window handle of the hardware installation wizard top-level window.
See Also