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


__dpmi_install_resident_service_provider_callback

Syntax

#include <dpmi.h>

int __dpmi_install_resident_service_provider_callback(
        __dpmi_callback_info *info
);

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 = 0x0c00 (DPMI 1.0 only). Not supported by CWSDPMI and Windows.

This function installs a resident service provider callback and declares an intent to provide resident protected-mode services after terminating with a call to __dpmi_terminate_and_stay_resident (see section __dpmi_terminate_and_stay_resident).

The various members of info should be filled as follows:

data16
An 8-byte descriptor for the 16-bit data segment.
code16
An 8-byte descriptor for the 16-bit code segment (zeros if not supported).
ip
A 16-bit offset of the 16-bit callback procedure.
data32
An 8-byte descriptor for 32-bit data segment.
code32
An 8-byte descriptor for 32-bit code segment (zeros if not supported).
eip
A 32-bit offset of the 32-bit callback procedure.

See section __dpmi_get_descriptor, for the details about the layout of the 8-byte segment descriptor.

Return Value

-1 on error, else zero.

Portability

not ANSI, not POSIX


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