Important Notice

The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.

                                                     ◄Up► ◄Next► ◄Previous►
────────────────────────────────────────────────────────────────────────────
 
include vmm.inc
 
VMMcall _AddFreePhysPage, <PhysPgNum, nPages, flags>
 
mov     [PagesAdded], eax       ; 0 = none, 1 = some, 2 = all
 
The _AddFreePhysPage service adds one or more physical pages to the free
memory pool. Virtual devices use this service to add pages that the Windows
loader could not find, but that the virtual device did find. For example,
the V86MMGR device adds any unused physical pages it finds when using the
Global EMM Import function of a 386 LIMulator.
 
This service is only available during initialization and only in Windows
version 3.1 and later.
 
Parameter  Description
────────────────────────────────────────────────────────────────────────────
 
PhysPgNum  Specifies the physical page number of the first page to add. The
           page number must be greater than or equal to 110h; only extended
           memory pages may be added to the pool. The specified pages must
           be read/write physical memory pages, and must be available for
           use at any time.
 
nPages     Specifies the number of physical pages to add.
 
flags      Specifies the operation flags. This parameter must be set to 0.
 
Return Value
 
The EAX register contains one of the following values:
 
Value  Meaning
────────────────────────────────────────────────────────────────────────────
0      None of the specified physical pages were added to the free pool.
 
1      Some, but not all, of the specified physical pages were added.
 
2      All of the specified physical pages were added.
 
Comments
 
A virtual device must not attempt to use pages once it has added them to the
free pool, or attempt to add pages that are already available to the
system.
 
This service returns an error if the number of pages to add exceeds the
limit of the internal data structure the system uses the manage the free
pool. The internal data structure is allocated during initialization and
cannot be modified.
 
Uses
 
EAX
 
See Also
 
_GetFreePageCount
 
 
                                      ♦