SwNtfy Fn 0001H: Can Switcher Suspend Your Session?

  Expect: AX    0001H
          BX    ID of the session that is about to be suspended
          ES:DI addr of switcher's service-entry address
          ──────────────────────────────────────────────────────────────────
  Return: AX    0000H if OK to suspend, as far as you're concerned
                0001H if you object to the switch
          ──────────────────────────────────────────────────────────────────
    Info: Task switchers call this fn when they are about to perform a
          session switch.  Your application can prevent the switch or
          perform any special cleanup needed, then allow the switch to take
          place.  When called, interrupts are enabled and all DOS fns can
          be used.

       BX will contain the session ID of the session that is about to be
          switched out.  Global TSRs may wish to take special actions for
          each session.

    ES:SI will contain the task switcher's service entry address.  Use this
          address if you need to call service fns such as SwSrvcFn 0001H
          (test memory region) to determine how you feel about being
          switched out.

  Return: AX=0000H if you have no objection to being switched out. If any
          task returns a non-zero value, the session will not be switched
          out and all tasks may receive SwNtfyFn 0004H (session is active).

See Also: Switcher Services and Notifications
          INT 2fH 4bxxH (switcher functions)
                                    -♦-