DEVESC DBE LAST: Difference between revisions
Created page with "{{DISPLAYTITLE:DEVESC_DBE_LAST}} 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) - in..." |
mNo edit summary |
||
| Line 6: | Line 6: | ||
==Parameters== | ==Parameters== | ||
;''hdc'' (HOC) - input | ;''hdc'' (HOC) - input:Device context handle | ||
:Device context handle | ;''lEscape'' (LONG) - input:DEVESC_DBE_LAST | ||
;''lEscape'' (LONG) - input | ;''clnCount'' (LONG) - input:The handling routine ignores this parameter | ||
:DEVESC_DBE_LAST | ;''pinData'' (PBYTE) - input:The handling routine ignores this parameter | ||
;''clnCount'' (LONG) - input | ;''pcOutCount'' (PLONG) - input:The handling routine ignores this parameter | ||
:The handling routine ignores this parameter | ;''pOutData'' (PLONG) - input:The handling routine ignores this parameter | ||
;''pinData'' (PBYTE) - input | ;''plnstance'' (PVOID) - input:Pointer to instance data | ||
:The handling routine ignores this parameter | ;''lFunction'' (ULONG) - input:High-order WORD= flags; low-order WORD= NGreEscape | ||
;''pcOutCount'' (PLONG) | |||
:The handling routine ignores this parameter | |||
;''pOutData'' (PLONG) | |||
: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== | ==Returns== | ||
;''rc'' ([[LONG]]) - returns: Return Code. | ;''rc'' ([[LONG]]) - returns: Return Code. | ||
:The handling routine returns: | :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: | ;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_DEV_FUNC_NOT_INSTALLED | ||
* PMERR_INV_LENGTH_OR_COUNT. | * PMERR_INV_LENGTH_OR_COUNT. | ||
Refer to Appendix B of the OS/2 2.0 Presentation Manager Programming Reference for further explanation | Refer to Appendix B of the ''OS/2 2.0 Presentation Manager Programming Reference'' for further explanation | ||
==Remarks== | ==Remarks== | ||
Latest revision as of 22:09, 6 September 2025
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)