en:docs:fapi:dosgetmachinemode

This is part of Family API which allow to create dual-os version of program runs under OS/2 and DOS

Note: This is legacy API call. It is recommended to use 32-bit equivalent

2021/09/17 06:47 · prokushev
2021/08/20 05:18 · prokushev

DosGetMachineMode

This call returns the current mode of the processor, whether the processor is running in the DOS mode or the OS/2 mode. This allows an application to determine whether a dynamic link call is valid or not.

Syntax

DosGetMachineMode (MachineMode)

Parameters

  • MachineMode (PBYTE) - output: Address of the value to indicate the current processor mode. This value may be:
    • 0 - DOS (real) mode
    • 1 - OS/2 (protected) mode.

Return Code

  • rc (USHORT) - return

Return code description is:

  • 0 NO_ERROR

Remarks

All dynamic link calls are available to an application if the MachineMode value indicates the program is in OS/2 mode. This method provides a self-tailoring application that allows the application to adapt to the execution environment by limiting or enhancing the functions it provides.

If the MachineMode value indicates the program is in DOS mode (or real), the application is limited to a subset of dynamic link calls listed in the Family API.

Example Code

C Binding

  #define INCL_DOSMISC
 
  USHORT  rc = DosGetMachineMode(MachineMode);
  PBYTE   MachineMode;   /* Processor mode (returned) */
  USHORT  rc;            /* return code /*/

MASM Binding

  EXTRN  DosGetMachineMode:FAR
  INCL_DOSMISC      EQU 1
 
  PUSH@  BYTE    MachineMode   ;Processor mode (returned)
  CALL   DosGetMachineMode

Returns WORD

Note


en/docs/fapi/dosgetmachinemode.txt · Last modified: 2021/09/17 08:09 by prokushev