PM_allocRealSeg

Allocate a block of real mode memory

Declaration

void * PMAPI PM_allocRealSeg(
uint size,
uint *r_seg,
uint *r_off)

Prototype In

pmapi.h

Parameters

size | Size of memory block to allocate
r_seg | Place to store real mode segment address of memory block
r_off | Place to store real mode segment offset of memory block

Return Value

Linear pointer to the real mode memory block, NULL on failure.

Description

This function is used to allocate a block of real mode memory for communicating with the real mode BIOS. If this function succeeds, the r_seg and r_off parameters will be filled in with the real mode address of the memory block, and the function will return a regular C style linear pointer to the memory block. This is only supported for operating systems that support BIOS access (ie: the PM_haveBIOSAccess function returns true).

See Also

PM_freeRealSeg, PM_mapRealPointer

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