BOOL VDDIncludeMem(hVDD, Address, nBytes)
IN HANDLE hVDD;
IN PVOID Address;
DWORD Size;
VDDIncludeMem includes a specified memory range so that it can be used as UMB.
Parameters
hVDD
Identifies the VDD handle.
Address
Points to the address where memory is to be included.
Size
Specifies the number of bytes to be included.
Return Value
VDDIncludeMem returns TRUE if successful. Otherwise, FALSE is logged and an error is returned. The available extended error code is ERROR_INVALID_ADDRESS—Invalid address.
Comments
If there is a ROM block in the attached adapter and the corresponding VDD knows that it will never use that ROM, the VDD may put the ROM memory space back to the UMB list so the memory is available to the DOS arena.
The address and the size must exactly match the ROM of the attached adapter. It is not allowed to include a portion of the ROM to be used as a UMB.