VioGlobalReg
Bindings: C, MASM
VioGlobalReg allows a subsystem to receive notification at the completion
of VIO calls issued by all applications running in full-screen sessions.
VioGlobalReg (ModuleName, EntryPoint, FunctionMask1, FunctionMask2, 0)
ModuleName (PSZ) - input
Address of the ASCIIZ string containing the 1-8 character file name of
the subsystem. The maximum length of the ASCIIZ string is 9 bytes
including the terminating byte of zero. The module must be a dynamic
link library but the name supplied must not include the .DLL
extension.
EntryPoint (PSZ) - input
Address of the ASCIIZ name string containing the dynamic link entry
point name of the routine in the subsystem to receive control when any
of the registered functions is called. The maximum length of the
ASCIIZ string is 33 bytes including the terminating byte of zero.
FunctionMask1 (ULONG) - input
A bit mask where each bit identifies a video function being
registered. The bit definitions are shown below. The first word
pushed onto the stack contains the high-order 16 bits of the function
mask, and the second word contains the low-order
16 bits.
BIT REGISTERED FUNCTION BIT REGISTERED FUNCTION
------------------------------------------------------------------
31 VioPrtScToggle 15 VioWrtCharStr
30 VioEndPopUp 14 VioWrtTTY
29 VioPopUp 13 VioWrtNCell
28 VioSavRedrawUndo 12 VioWrtNAttr
27 VioSavRedrawWait 11 VioWrtNChar
26 VioScrUnLock 10 VioReadCellStr
25 VioScrLock 9 VioReadCharStr
24 VioPrtSc 8 VioShowBuf
23 VioGetAnsi 7 VioSetMode
22 VioSetAnsi 6 VioSetCurType
21 VioScrollRt 5 VioSetCurPos
20 VioScrollLf 4 VioGetPhysBuf
19 VioScrollDn 3 VioGetBuf
18 VioScrollUp 2 VioGetMode
17 VioWrtCellStr 1 VioGetCurType
16 VioWrtCharStrAtt 0 VioGetCurPos
FunctionMask2 (ULONG) - input
A bit mask where each bit identifies a video function being
registered. The bit mask has the format shown below. The first word
pushed onto the stack contains the high order 16 bits of the function
mask, and the second word contains the low order 16 bits. Unused bits
are reserved and must be set to zero.
Bit Registered Function
31-11 Reserved, must be set to zero.
10 VioDeRegister
9 VioRegister
8 VioSetState
7 VioGetState
6 VioSetFont
5 VioGetCp
4 VioSetCp
3 VioGetConfig
2 VioGetFont
1 VioModeUndo
0 VioModeWait
Reserved (LONG) - input
Reserved and must be zero.
rc (USHORT) - return
Return code descriptions are:
0 NO_ERROR
349 ERROR_VIO_INVALID_MASK
403 ERROR_VIO_INVALID_ASCIIZ
426 ERROR_VIO_REGISTER
494 ERROR_VIO_EXTENDED_SG
Remarks
Notification of VIO calls issued within the hard error handler and DOS
(real mode) sessions is not provided.
When control is routed to EntryPoint, the stack appears as it did after
the original VIO call except that four additional values have been pushed
onto the stack. The first is the index number (WORD) of the routine
called. The second is a near pointer (WORD). The third is the caller's
DS register (WORD). The fourth is the return address (DWORD) to the VIO
router.
For example, if VioSetCurPos were a registered function, the stack would
appear as if the following instruction sequence were executed if
VioSetCurPos were called and control routed to EntryPoint:
+-------------------------------------------------------+
| PUSH WORD Row |
| PUSH WORD Column |
| PUSH WORD VioHandle |
| CALL FAR VioSetCurPos |
| PUSH WORD Index |
| CALL NEAR Entry point in Vio router |
| PUSH WORD Caller's DS |
| CALL FAR Dynamic link entry point |
+-------------------------------------------------------+
The index numbers that correspond to the registered functions are listed
below:
0 VioGetPhysBuf 22 VioSetAnsi
1 VioGetBuf 23 VioGetAnsi
2 VioShowBuf 24 VioPrtSc
3 VioGetCurPos 25 VioScrLock
4 VioGetCurType 26 VioScrUnLock
5 VioGetMode 27 VioSavRedrawWait
6 VioSetCurPos 28 VioSavRedrawUndo
7 VioSetCurType 29 VioPopUp
8 VioSetMode 30 VioEndPopUp
9 VioReadCharStr 31 VioPrtScToggle
10 VioReadCellStr 32 VioModeWait
11 VioWrtNChar 33 VioModeUndo
12 VioWrtNAttr 34 VioGetFont
13 VioWrtNCell 35 VioGetConfig
14 VioWrtCharStr 36 VioSetCp
15 VioWrtCharStrAtt 37 VioGetCp
16 VioWrtCellStr 38 VioSetFont
17 VioWrtTTY 39 VioGetState
18 VioScrollUp 40 VioSetState
19 VioScrollDn 41 VioRegister
20 VioScrollLf 42 VioDeRegister
21 VioScrollRt
On entry to the global subsystem, AX contains the return code that is
returned to the application that issued the VIO call. The global
subsystem must return with all stack parameters and all general purpose
registers, including AX, restored to the same values as on entry.
All VIO functions within a session are serialized on a thread basis.
That is, when a global subsystem receives control, it can safely assume
that it is not called again from the same session until the current call
has completed. Note, however, that VIO calls across different sessions
are not serialized.
VioGlobalReg may only be issued during system initialization. After
system initialization, VioGlobalReg returns ERROR_VIO_REGISTER. A
globally registered subsystem is active for the life of the system.
If multiple global subsystems are registered, they are given control in
the order that they are registered.
A globally registered subsystem receives control on VIO calls issued from
all full-screen sessions except the hard error handler and DOS (real
mode) sessions.
Created using Inf-PHP v.2 (c) 2003 Yuri Prokushev
Created using Inf-HTML v.0.9b (c) 1995 Peter Childs