83Plus:BCALLs:4021 - Revision history

Luby at 15:47, 6 February 2008

2008-02-06T15:47:51Z

Luby: Destroys

2008-02-06T15:47:37Z

Destroys

Luby at 03:06, 6 February 2008

2008-02-06T03:06:16Z

Dan Englender: Links

2005-04-26T15:53:06Z

Links

Woozle at 00:00, 13 April 2005

2005-04-13T00:00:15Z

New page

[[Category:83Plus:BCALLs:By Name:Monitor|MonForceKey]] [[Category:83Plus:BCALLs:By Name|MonForceKey]] [[Category:83Plus:BCALLs:By Address|4021 - MonForceKey]]
== Synopsis ==
'''Official Name:''' MonForceKey

'''BCALL Address:''' 4021

Calls the system monitor but allows the programmer to push an initial key through cxMain. This is very much like [[83Plus:BCALLs:401E|Mon]].

=== Inputs ===
* a = initial key press to simulate
* AppAllowContext, (IY + APIFlg) = 1 to allow Mon to pass context keys, like
* kYequ to the cxMain routine.
* CurLock, (IY + curFlags) = 1 to lock the cursor off

=== Outputs ===
* none

=== Registers Destroyed ===
* ??

== Comments ==
The system NEVER returns from this B_CALL. The programmer should find alternative methods of regaining control and exiting such as hooks, cxMain, etc.

== Example ==
To simulate a key press by the user when first entering the system monitor:

;set up edit buffer
;...
ld a,k8
B_CALL MonForceKey ;should see the number 8 appear in the edit buffer

@@ Line 18: / Line 18: @@
 === Registers Destroyed ===
-* unknown
+* Doesn't matter because it doesn't return
 == Comments ==

@@ Line 1: / Line 1: @@
 [[Category:83Plus:BCALLs:By Name:Monitor|MonForceKey]] [[Category:83Plus:BCALLs:By Name|MonForceKey]] [[Category:83Plus:BCALLs:By Address|4021 - MonForceKey]]
-{{missinfo|Destroys}}
 == Synopsis ==
 '''Official Name:''' MonForceKey

@@ Line 5: / Line 5: @@
 '''BCALL Address:''' 4021
-Calls the system monitor but allows the programmer to push an initial key through cxMain.  This is very much like [[83Plus:BCALLs:401E|Mon]].
+Calls the system monitor but allows the programmer to push an initial key through [[83Plus:RAM:858D|cxMain]].  This is very much like [[83Plus:BCALLs:401E|Mon]].
 === Inputs ===
 * a = initial key press to simulate
-* AppAllowContext, (IY + APIFlg) = 1 to allow Mon to pass context keys, like
+* [[83Plus:Flags:28|AppAllowContext, (IY + APIFlg)]] = 1 to allow Mon to pass context keys, like
 * kYequ to the cxMain routine.
-* CurLock, (IY + curFlags) = 1 to lock the cursor off
+* [[83Plus:Flags:0C|CurLock, (IY + curFlags)]] = 1 to lock the cursor off
 === Outputs ===