__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 the DPMI Specification (see section DPMI Specification) for details on DPMI function call operation. Also see the DPMI Overview (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

ANSI/ISO C	No
POSIX	No