VioPrtSc: Difference between revisions

Latest revision as of 19:27, 1 January 2020

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.

Bindings

C

#define INCL_VIO

USHORT  rc = VioPrtSc(VioHandle);
HVIO    VioHandle;     /* Vio handle */

USHORT  rc;            /* return code */

MASM

EXTRN  VioPrtSc:FAR
INCL_VIO            EQU 1

PUSH   WORD    VioHandle     ;Vio handle
CALL   VioPrtSc

Returns WORD

@@ Line 1: / Line 1: @@
-==Description==
+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==
-<PRE>
+  VioPrtSc (VioHandle)
-  VioPrtSc
-    (VioHandle)
-</PRE>
 ==Parameters==
-;  VioHandle (HVIO) - input :  Reserved word of 0s.
+;VioHandle (HVIO) - input: Reserved word of 0s.
 ==Return Code==
- rc (USHORT) - return
+;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
-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===
+==Bindings==
+===C===
 <PRE>
 #define INCL_VIO
 USHORT  rc = VioPrtSc(VioHandle);
+HVIO    VioHandle;     /* Vio handle */
-HVIO             VioHandle;     /* Vio handle */
+USHORT  rc;            /* return code */
+</PRE>
-USHORT           rc;            /* return code */
+===MASM===
-</PRE>
-=== MASM Binding===
 <PRE>
 EXTRN  VioPrtSc:FAR
@@ Line 44: / Line 40: @@
 Returns WORD
+</PRE>
+[[Category:Vio]]
-</PRE>
-==Related Functions==
-*
-[[Category:The OS/2 API Project]]