DIF_ADDPROPERTYPAGE_ADVANCED

Article
12/15/2021

A DIF_ADDPROPERTYPAGE_ADVANCED request allows an installer to supply one or more custom property pages for a device.

When Sent

When a user clicks on the properties for a device in Device Manager or in Control Panel.

Who Handles

Class Co-installer	Can handle
Device Co-installer	Can handle
Class Installer	Can handle

Installer Input

DeviceInfoSet
Supplies a handle to the device information set that contains the device.

DeviceInfoData
Optionally supplies a pointer to an SP_DEVINFO_DATA structure that identifies the device in the device information set. If DeviceInfoSet is NULL, Windows is requesting property pages for the device setup class.

Device Installation Parameters
Device installation parameters (SP_DEVINSTALL_PARAMS) are associated with the DeviceInfoData, if specified, or with the DeviceInfoSet.

Class Installation Parameters
An SP_ADDPROPERTYPAGE_DATA structure is associated with the DeviceInfoData, if specified, or with the DeviceInfoSet.

Installer Output

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

Class Installation Parameters
An installer can modify the SP_ADDPROPERTYPAGE_DATA to supply custom pages.

Installer Return Value

A co-installer can return NO_ERROR or a Win32 error. A co-installer should not return ERROR_DI_POSTPROCESSING_REQUIRED for this DIF request.

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

Default DIF Code Handler

None

Installer Operation

In response to this DIF request an installer can supply custom property pages. Handling this DIF request allows you to supply property pages from a class installer or co-installer and removes the need for a separate DLL that acts as a property-page provider.

An installer typically handles this DIF request to add a new device-specific or setup-class-specific property page. An installer can also replace the system-supplied driver property page, resource property page, or power property page for a device. If an installer replaces a system-supplied page, the installer must set the appropriate flag in the device installation parameters for the device:

DI_DRIVERPAGE_ADDED
The installer supplied a driver property page.

DI_RESOURCEPAGE_ADDED
The installer supplied a resource property page.

DI_FLAGSEX_POWERPAGE_ADDED
The installer supplied a power property page.

An installer cannot replace the system-supplied general properties page.

Windows only displays one driver page, one resource page, and one power page for a device. An installer should not supply a replacement system page if a previous installer already supplied a page of that type. This constraint does not apply to nonsystem-supplied property pages.

A co-installer should add custom pages in its preprocessing pass.

If an installer allows a user to set a property that requires Windows to remove and restart the device, the installer must set the DI_FLAGSEX_PROPCHANGE_PENDING flag in the device installation parameters from its DialogProc routine.

For more information about how to provide device property pages, see Providing Device Property Pages.

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)