VioPrtSc: Difference between revisions
m Ak120 moved page OS2 API:CPI:LEGACY:VioPrtSc to VioPrtSc |
mNo edit summary |
||
| Line 1: | Line 1: | ||
This call is issued by the Session Manager when the operator presses PrtSc. | This call is issued by the Session Manager when the operator presses PrtSc. | ||
==Syntax== | ==Syntax== | ||
VioPrtSc (VioHandle) | |||
VioPrtSc | |||
==Parameters== | ==Parameters== | ||
; | ;VioHandle (HVIO) - input : Reserved word of 0s. | ||
==Return Code== | ==Return Code== | ||
rc (USHORT) - return | rc (USHORT) - return | ||
Return code descriptions are: | Return code descriptions are: | ||
* 0 NO_ERROR | |||
* 355 ERROR_VIO_MODE | |||
* 402 ERROR_VIO_SMG_ONLY | |||
* 436 ERROR_VIO_INVALID_HANDLE | |||
* 465 ERROR_VIO_DETACHED | |||
==Remarks== | ==Remarks== | ||
VioPrtSc supports text modes 0 through 3, and 7. An Alternate Video Subsystem may want to register a replacement for VioPrtSc. An advanced video subsystem could set a graphics mode while the mode known to the base video subsystem PrtSc routine is text. Then, if the operator presses PrtSc, the printer output is unpredictable. VioPrtSc is reserved for use by the session manager. Application programs may not issue VioPrtSc. | VioPrtSc supports text modes 0 through 3, and 7. An Alternate Video Subsystem may want to register a replacement for VioPrtSc. An advanced video subsystem could set a graphics mode while the mode known to the base video subsystem PrtSc routine is text. Then, if the operator presses PrtSc, the printer output is unpredictable. VioPrtSc is reserved for use by the session manager. Application programs may not issue VioPrtSc. | ||
Three beeps are generated if a hard error is detected while writing to the printer. | Three beeps are generated if a hard error is detected while writing to the printer. | ||
==Example Code== | ==Example Code== | ||
===C Binding=== | ===C Binding=== | ||
| Line 35: | Line 32: | ||
USHORT rc; /* return code */ | USHORT rc; /* return code */ | ||
</PRE> | </PRE> | ||
=== MASM Binding=== | === MASM Binding=== | ||
<PRE> | <PRE> | ||
| Line 44: | Line 42: | ||
Returns WORD | Returns WORD | ||
</PRE> | |||
[[Category:Vio]] | |||
[[Category: | |||
Revision as of 07:12, 10 February 2017
This call is issued by the Session Manager when the operator presses PrtSc.
Syntax
VioPrtSc (VioHandle)
Parameters
- VioHandle (HVIO) - input
- Reserved word of 0s.
Return Code
rc (USHORT) - return
Return code descriptions are:
- 0 NO_ERROR
- 355 ERROR_VIO_MODE
- 402 ERROR_VIO_SMG_ONLY
- 436 ERROR_VIO_INVALID_HANDLE
- 465 ERROR_VIO_DETACHED
Remarks
VioPrtSc supports text modes 0 through 3, and 7. An Alternate Video Subsystem may want to register a replacement for VioPrtSc. An advanced video subsystem could set a graphics mode while the mode known to the base video subsystem PrtSc routine is text. Then, if the operator presses PrtSc, the printer output is unpredictable. VioPrtSc is reserved for use by the session manager. Application programs may not issue VioPrtSc.
Three beeps are generated if a hard error is detected while writing to the printer.
Example Code
C Binding
#define INCL_VIO USHORT rc = VioPrtSc(VioHandle); HVIO VioHandle; /* Vio handle */ USHORT rc; /* return code */
MASM Binding
EXTRN VioPrtSc:FAR INCL_VIO EQU 1 PUSH WORD VioHandle ;Vio handle CALL VioPrtSc Returns WORD