DEVESC_DBE_LAST
Appearance
This function informs the presentation driver that character codes for subsequent output data will use one byte per character.
Syntax
GreEscape (hdc, DEVESC_DBE_LAST, clnCount, plnData, pcOutCount, pOutData, plnstance, lFunction)
Parameters
- hdc (HOC) - input
- Device context handle
- lEscape (LONG) - input
- DEVESC_DBE_LAST
- clnCount (LONG) - input
- The handling routine ignores this parameter
- pinData (PBYTE) - input
- The handling routine ignores this parameter
- pcOutCount (PLONG) - input
- The handling routine ignores this parameter
- pOutData (PLONG) - input
- The handling routine ignores this parameter
- plnstance (PVOID) - input
- Pointer to instance data
- lFunction (ULONG) - input
- High-order WORD= flags; low-order WORD= NGreEscape
Returns
- rc (LONG) - returns
- Return Code.
- The handling routine returns:
- DEV_OK
- Successful
- DEVESC_NOTIMPLEMENTED
- Escape not implemented for specified code
- DEVESC_ERROR
- Error.
- Possible Errors Detected
- When an error is detected, the handling routine must call WinSetErrorlnfo to post the condition. Error codes for conditions that the handling routine is expected to check include:
- PMERR_DEV_FUNC_NOT_INSTALLED
- PMERR_INV_LENGTH_OR_COUNT.
Refer to Appendix B of the OS/2 2.0 Presentation Manager Programming Reference for further explanation
Remarks
For an OD_METAFILE device, DEVESC_DBE_LAST is passed to the presentation driver but is not metafiled. For an OD_QUEUED device with PM_Q_STD, the spooler records this escape and it is not passed to the presentation driver.
Example Code
Declaration:
#define INCL_GRE_DEVICE LONG GreEscape (hdc, DEVESC_DBE_LAST, clnCount, plnData, pcOutCount, pOutData, plnstance, lFunction)