DrvDevicePropertySheets function

A printer interface DLL's DrvDevicePropertySheets function is responsible for creating property sheet pages that describe a printer's properties.


LONG DrvDevicePropertySheets(
           LPARAM            lParam


pPSUIInfo [in, optional]

Caller-supplied pointer to a PROPSHEETUI_INFO structure.


Caller-supplied integer value that is dependent on the contents of the Reason member of the PROPSHEETUI_INFO structure, as listed in the following table.

Reason valueDefinition of lParam


Pointer to a DEVICEPROPERTYHEADER structure.

All other reason values

See the description of the lParam parameter for the PFNPROPSHEETUI function type.

(The DEVICEPROPERTYHEADER structure's address is contained in the lParamInit member of the PROPSHEETUI_INFO structure.)


Return value

See the ReturnValue section in the description of the PFNPROPSHEETUI function type.


All printer interface DLLs must provide a DrvDevicePropertySheets function, which is defined using the PFNPROPSHEETUI function type. The function's purpose is to call the ComPropSheet function, provided by CPSUI, to specify a property sheet page containing user-modifiable properties for the printer.

The function should perform operations as described for the PFNPROPSHEETUI function type. The function should create the printer's DeviceSettings property sheet page (see the pDlgPage member of the COMPROPSHEETUI structure).

Printer device settings should be stored in the registry. If a user with administrator privilege modifies options on the DeviceSettings page, the DrvDevicePropertySheets function should write the updated values to the registry by calling SetPrinterData (described in the Microsoft Windows SDK documentation).


Target platform


Winddiui.h (include Winddiui.h)

See also




Send comments about this topic to Microsoft