## Presentation Device Driver Reference for OS/2

[prev][next][parent][TOC]

### OS2_PM_DRV_DEVMODE - Parameters

pDriverData (PDRIVDATA) - input NULL or pointer to memory location for DRIVDATA structure:

cb Number of bytes in the structure.

lVersion Version number of the presentation driver. Subsequently used by the presentation driver to verify its entry in the INI file.

szDeviceName[32] Device name.

abGeneralData Driver-specific data for job or printer properties.

If pDriverData is NULL, the handling routine in the presentation driver must return the length of the driver's DRIVDATA structure for either job or printer properties.

pszDriverName (PSZ) - input A pointer to a string containing the name of the hardcopy driver.

pszDeviceName (PSZ) - input A pointer to a string containing the device name, such as HP LASERJET II P, as defined by the presentation driver.

pszPrinterName (PSZ) - input A NULL or pointer to a string containing the printer name, such as PRINTER1. A NULL pointer or NULL string are both valid conditions for this parameter.

lOptions (ULONG) - input Identifies the action that should be taken by the presentation driver:

DPDM_POSTJOBPROP Display a dialog for job properties and return the DRIVDATA structure. Do not update OS2SYS.INI. The abGeneralData field contains the job properties.

DPDM_CHANGEPROP Display a dialog for printer properties and device defaults , update the OS2SYS.INI file, and return the DRIVDATA structure. The abGeneralData field contains the printer properties.

DPDM_QUERYJOBPROP Return the DRIVDATA structure with device default job properties. Do not display a dialog. The abGeneralData field contains the device default job properties.

All other values are reserved.

rc (ULONG) - returns Return codes.

The handling routine in the presentation driver returns a LONG integer. Valid values are:

DPDM_ERROR Error.

DPDM_NONE There are no settable options.

>0 The number of bytes for the required DRIVDATA structure when the input pointer pDriverData is equal to NULL.

DEV_OK The data block pointed to by the input parameter pDriverData was initialized when the pDriverData input pointer is not equal to NULL.