DrvDevicePropertySheets function

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

Syntax


LONG DrvDevicePropertySheets(
  _In_opt_  PPROPSHEETUI_INFO pPSUIInfo,
  LPARAM lParam
);

Parameters

pPSUIInfo [in, optional]

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 valueDefinition 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

Header

Winddiui.h (include Winddiui.h)

See also

DrvDocumentPropertySheets
IPrintOemUI::DevicePropertySheets

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft