ulSubfunction (ULONG) - input

02h.

pParam1 (PULONG) - input

A pointer to an extended DEVOPENSTRUC structure (the structure is extended by adding a DENPARAMS structure to give three additional fields: ulStateInfo, ulType, and ulHDC).

pszLogAddress

Pointer to the logical address of the device, such as "LPT1Q".
pszDriverName
Pointer to name of the presentation driver, such as 'LaserJet'.
pdriv
Pointer to DRIVDATA structure. This structure contains data generated by the presentation driver during the dialog that sets device modes. See OS2_PM_DRV_DEVMODE.

cb

Number of bytes in the structure
lVersion
Version number
szDeviceName[32]
Device name
abGeneralData
Driver-specific data
pszDataType
Pointer to the name of the queue file data type:

PM_Q_STD PM_Q_RAW

pszComment
Pointer to a file description that the spooler could use in messages displayed to the user; usually the name of the application by convention.
pszQueueProcName
Pointer to name of queue driver (queue processor).
pszQueueProcParams
Pointer to a string of queue processor parameters.
pszSpoolerParams
Pointer to a string of spooler parameters separated by one or more blanks.

FORM=aaa

Identifies the form name for the print job. Multiple names are separated by commas (aaa,bbb,ccc). If this parameter is not present the job is printed on the current form.

Form names are defined by the presentation driver. Valid names are those that are returned from a call to the driver's GreQueryHardcopyCaps handling routine.

pszNetworkParams
Pointer to a string of networking parameters.
ulStateInfo
Reserved. This field does not contain meaningful information at this time.
ulType
DC type (for example, OD_QUEUED).
ulHDC
DC handle.

pParam2 (PLONG) - input

Pointer to the dispatch table

Pointer to the dispatch table if Bit 7 was set in FillLogicalDeviceBlock and the Graphics Engine version is 0x202 or later.

rc (LONG) - returns

Return codes.

The handling routine should return a LONG integer. Valid values are:

• Error. Other
  Handle or pointer, ulStateInfo, to the physical device block. This pointer is passed back to the presentation driver in subsequent calls to the OS2_PM_DRV_ENABLE subfunctions 04h and 05h.

  Note: The name, pDCI, is used in place of ulStateInfo in some source code.

  ---

  [Back: OS2_PM_DRV_ENABLE: Subfunction 02h - FillPhysicalDeviceBlock Return Value - rc]
  [Next: OS2_PM_DRV_ENABLE: Subfunction 02h - FillPhysicalDeviceBlock - Remarks]