PM_callRealMode

Call a real mode far function.

Declaration

void PMAPI PM_callRealMode(
uint seg,
uint off,
RMREGS *in,
RMSREGS *sregs)

Prototype In

pmapi.h

Parameters

seg | Real mode segment address of function to call
off | Real mode segment offset of function to call
in | Register block to load before calling interrupt
sregs | Segment register block to load and return values in

Description

This function is used call a real mode far function, which is used to call the real mode BIOS functions and drivers directly. If you make calls to the real mode BIOS functions or drivers with this function, there is no parameter translation at all. Hence you need to translate any real mode memory pointers etc passed into and returned from this function with the PM_allocRealSeg and PM_mapRealPointer functions.

When this function executes the real mode far function, the machine registers will be loaded with the values passed in the 'in' parameter and the segment registers from the 'sregs' parameter. When the function returns, the values in the machine registers will then be saved into the 'out' parameter and the segment registers into the 'sregs' parameter.

This is only supported for operating systems that support BIOS access (ie: the PM_haveBIOSAccess function returns true).

See Also

PM_int86, PM_int86x, PM_allocRealSeg

Copyright © 2002 SciTech Software, Inc. Visit our web site at http://www.scitechsoft.com