Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

CLI-related attributes refer to Application Type Byte 1 in application DOR.


NQ_Khn

Code Block
languagenone
titleNQ_Khn ($8603), Read keyboard handle
IN:  BC = NQ_Khn
OUT: IX = keyboard handle

Registers changed after return:
     A.BCDEHL/..IY same
     .F....../IX.. different

Notes

Use ":INP" device instead.

 

NQ_Shn

Code Block
languagenone
titleNQ_Shn ($8606), Read screen handle
IN:  BC = NQ_Shn
OUT: IX = screen handle

Registers changed after return:
     A.BCDEHL/..IY same
     .F....../IX.. different

Notes

Use ":SCR" device instead.

 

NQ_Phn

Code Block
languagenone
titleNQ_Phn ($8609), Read printer indirected handle
IN:  BC = NQ_Phn
OUT: IX = printer indirected handle

Registers changed after return:
     A.BCDEHL/..IY same
     .F....../IX.. different

 

NQ_Nhn

Code Block
languagenone
titleNQ_Nhn ($860C), Read null handle
IN:  BC = NQ_Hhn
OUT: IX = null handle

Registers changed after return:
     A.BCDEHL/..IY same
     .F....../IX.. different

Notes

Use ":NUL" device instead

 

NQ_Wai

Code Block
languagenone
titleNQ_Wai ($860F), Who am I? (system use only)
IN:  BC = NQ_Wai
OUT: IX = static process handle
     C = dynamic process handle (PID)
	 B = 0

Registers changed after return:
     A...DEHL/..IY same
     .FBC..../IX.. different

Notes

  • Static process handle is unique to each application. It follows slot number and application order in slot (1-31 for internal slot, 32-63 for slot 1, 64-95 for slot 2, 96-127 for slot 3, 128-255 for installed applications). Index handle is always 1, Pipedream handle is 3...
  • Dynamic process handle (PID equivalent) is unique to each suspended or running process (range 2-127, Index PID is always number 1).

NQ_Com

Code Block
languagenone
titleNQ_Com ($8612), Read comms handle
IN:  BC = NQ_Com
OUT: IX = comms handle

Registers changed after return:
     A.BCDEHL/..IY same
     .F....../IX.. different

Notes

Use ":COM" device instead.

 

NQ_Ihn

Code Block
languagenone
titleNQ_Ihn ($8615), Read IN handle
IN:  BC = NQ_Ihn
OUT: IX = IN handle

Registers changed after return:
     A.BCDEHL/..IY same
     .F....../IX.. different

Notes

Use ":INP" device instead.

 

NQ_Ohn

Code Block
languagenone
titleNQ_Ohn ($8618), Read OUT handle
IN:  BC = NQ_Ohn
OUT: IX = OUT handle

Registers changed after return:
     A.BCDEHL/..IY same
     .F....../IX.. different

Notes

Use ":OUT" device instead.

 

NQ_Rhn

Code Block
languagenone
titleNQ_Rhn ($861B), Read direct printer handle
IN:  BC = NQ_Rhn
OUT: IX = printer direct handle

Registers changed after return:
     A.BCDEHL/..IY same
     .F....../IX.. different

 

NQ_Voz

Code Block
titleNQ_Voz ($861E), Application verifies running OZ version (OZ V4.5 and newer)
IN:
    A  = check OZ version required (for example $45 for OZ V4.5)
    BC = NQ_Voz
 
OUT, if call successful:
     Fc = 0
     Running OZ is equal to or higher than specified version

OUT, if call reported incompatible OZ ROM:
     Fc = 1
     A = RC_QUITVOZ ($67$38), OZ version not compatible
 
Registers changed after return:
     A.BCDEHL/IXIY same
     .F....../.... different

Notes:

if If OS_Nq, NQ_Voz is used on OZ ROM's earlier than V4.5, a standard "Internal Error" popup window is displayed to prompt the user to press ESC (the NQ_Voz doesnt exist).

For OZ V4V5.5 0 and later a similar but more correct window is displayed with "This application requires OZ VX.Y or newer" message if the specified OZ release is newer than what is currently running. , the "OZ version not compatible" message is displayed as a fatal error using a OS_BYE with A unchanged if Fc = 1.

NQ_Roz

Code Block
titleNQ_Roz ($8621), Read OZ revision number (OZ V4.5 and newer)
IN:
    -
  
OUT:
     DEBC = OZ revision number
  
Registers changed after return:
     AF....HL/IXIY same
     ..BCDE../.... different

Notes:

Used by system information page in Index.

 

NQ_Btl

Code Block
titleNQ_Btl ($8624), Read battery status (OZ V4.5 and newer)
IN:
    -
  
OUT:
     Fz = 0, Battery is good
	 Fz = 1, Battery is low
  
Registers changed after return:
     A.BCDEHL/IXIY same
     .F....../.... different

Notes:

Battery low condition is set when under 4.2V. Coma state is entered by NMI when battery voltage falls under 3.2V.

This call is used by system information page in Index.