C Language and Libraries Help (clang.hlp) (Table of Contents; Topic list)
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.
_vload
 Summary Example                         Up Contents Index Back
─────Run-Time Library───────────────────────────────────────────────────────
 
     The _vload function loads a virtual memory block into DOS memory
     and returns a far pointer to it. The argument <handle> points to a
     virtual memory block previously allocated through a call to
     _vmalloc or _vrealloc.
 
     The block of memory is not locked and can be swapped out if the
     virtual memory manager needs the memory. Consequently, the pointer
     returned by _vload is valid only until the next call to the
     virtual memory manager.
 
     The <dirty> flag indicates whether the block of memory should be
     written out or discarded when swapping occurs. It can have one of
     the following values:
 
     Value          Meaning
 
     _VM_CLEAN      Discard contents of block when swapping occurs
 
     _VM_DIRTY      Write contents of block to auxiliary memory when
                    swapping occurs
 
     Return Value
 
     The _vload function returns a far pointer to DOS memory if the
     virtual memory block is successfully loaded. If insufficient DOS
     memory is available, _vload returns NULL.
                                    -♦-