DrvDevicePropertySheets function (winddiui.h)

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

Syntax

LONG DrvDevicePropertySheets(
  [in, optional] PPROPSHEETUI_INFO pPSUIInfo,
                 LPARAM            lParam
);

Parameters

[in, optional] pPSUIInfo

Caller-supplied pointer to a PROPSHEETUI_INFO structure.

lParam

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 value Definition of lParam
PROPSHEETUI_REASON_INIT 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.

Remarks

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).

Requirements

Requirement Value
Target Platform Desktop
Header winddiui.h (include Winddiui.h)

See also

DrvDocumentPropertySheets

IPrintOemUI::DevicePropertySheets