Go to the first, previous, next, last section, table of contents.


__dpmi_terminate_and_stay_resident

Syntax

#include <dpmi.h>

int __dpmi_terminate_and_stay_resident(int return_code, 
                                       int paragraphs_to_keep);

Description

Please refer to section DPMI Specification for details on DPMI function call operation. Also see section DPMI Overview for general information.

DPMI function AX = 0x0c01 (DPMI 1.0 only). Not supported by CWSDPMI and Windows.

This function terminates the calling program, but leaves it resident in memory. return_code specifies which value to return to the OS. paragraphs_to_keep specifies the number of paragraphs of DOS (conventional) memory to keep; it should be either zero or 6 or more. Note that any protected-mode memory remains allocated to the program unless explicitly freed before calling this function.

The calling program must call the function __dpmi_install_resident_service_provider_callback before this one, otherwise it will be terminated instead of going TSR. See section __dpmi_install_resident_service_provider_callback.

Return Value

This call does not return.

Portability

not ANSI, not POSIX


Go to the first, previous, next, last section, table of contents.