The following codes use/return system handles:
IN: BC = NQ_Ain IX = application handle from OS_Poll OUT, if call successful: Fc = 0 BHL = pointer to application name (null-terminated) BDE = pointer to application DOR A = CLI-related attributes C = preferred code letter. OUT, if call failed: Fc = 1 A = RC_HAND Registers changed after return: ......../IXIY same AFBCDEHL/.... different |
CLI-related attributes refer to Application Type Byte 1 in application DOR.
IN: BC = NQ_Khn OUT: IX = keyboard handle Registers changed after return: A.BCDEHL/..IY same .F....../IX.. different |
Use ":INP" device instead.
IN: BC = NQ_Shn OUT: IX = screen handle Registers changed after return: A.BCDEHL/..IY same .F....../IX.. different |
Use ":SCR" device instead.
IN: BC = NQ_Phn OUT: IX = printer indirected handle Registers changed after return: A.BCDEHL/..IY same .F....../IX.. different |
IN: BC = NQ_Hhn OUT: IX = null handle Registers changed after return: A.BCDEHL/..IY same .F....../IX.. different |
Use ":NUL" device instead
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 |
IN: BC = NQ_Com OUT: IX = comms handle Registers changed after return: A.BCDEHL/..IY same .F....../IX.. different |
Use ":COM" device instead.
IN: BC = NQ_Ihn OUT: IX = IN handle Registers changed after return: A.BCDEHL/..IY same .F....../IX.. different |
Use ":INP" device instead.
IN: BC = NQ_Ohn OUT: IX = OUT handle Registers changed after return: A.BCDEHL/..IY same .F....../IX.. different |
Use ":OUT" device instead.
IN: BC = NQ_Rhn OUT: IX = printer direct handle Registers changed after return: A.BCDEHL/..IY same .F....../IX.. different |
IN: A = 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_VOZ ($38), OZ version not compatible Registers changed after return: A.BCDEHL/IXIY same .F....../.... different |
Notes:
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 V5.0 and later, the "OZ version not compatible" message is displayed as a fatal error using a OS_BYE with A unchanged if Fc = 1.
IN: - OUT: DEBC = OZ revision number Registers changed after return: AF....HL/IXIY same ..BCDE../.... different |
Notes:
Used by system information page in Index.
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.