LONG DrvDocumentPropertySheets(
| PPROPSHEETUI_INFO pPSUIInfo, | |
| LPARAM lParam | |
| ); |
DrvDocumentPropertySheets adds the driver's document property pages to the specified property sheet.
Parameters
pPSUIInfo
Pointer to a PROPSHEETUI_INFO structure containing the information necessary to call back to the CPSUI for the actual property sheet construction.
lParam
Pointer to a DOCUMENTPROPERTYHEADER structure.
Return Value
DrvDocumentPropertySheets returns a value greater than zero if it succeeds; it returns a value equal to or less than zero if it fails.
Comments
DrvDocumentPropertySheets is called when a user requests that a printer's document properties be displayed and/or updated.
If pPSUIInfo is null, the caller is the spooler, so the driver need not call the CPSUI because no user interface is required. Instead, the driver should perform the operation requested in the fMode member of the DOCUMENTPROPERTYHEADER structure. If fMode is zero or the pdmOut member is null, the driver should simply return the size in bytes of its DEVMODE structure.
If pPSUIInfo is not null, the caller is the CPSUI. In this situation, DrvDocumentPropertySheets should follow the implementation guidelines laid out in PFNPROPSHEETUI. This function allows vendors to provide device-specific document property information to the CPSUI for inclusion as a page on a common property sheet.