SwNtfy Fn 0002H: Switcher Is Suspending Your Session

  Expect: AX    0002H
          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 first call SwNtfyFn 0001H to see if a session
          switch is OK, then they call this fn directly before suspending
          your session.  This is the last chance for your application to
          prevent the switch.  When called, interrupts are disabled you
          should NOT use any DOS fns.

       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)
                                    -♦-