_go32_dpmi_allocate_real_mode_callback_retf

Syntax

#include <dpmi.h>

int _go32_dpmi_allocate_real_mode_callback_retf(_go32_dpmi_seginfo *info, _go32_dpmi_registers *regs);

Description

See section DPMI Overview

This function allocates a "real-mode callback". Fill in the pm_offset field of info and call this function. It will fill in the rm_segment and rm_offset fields. Any time a real-mode program calls the real-mode address, your function gets called. The registers in affect will be stored in regs, which should be a global, and will be passed to your function. Any changes in regs will be reflected back into real mode. A wrapper will be added to your function to simulate the effects of a far return, such as the callback for the packet driver receiver.

Return Value

Zero on success, nonzero on failure.

Portability

not ANSI, not POSIX

Example

See section _go32_dpmi_allocate_real_mode_callback_iret

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