VDDIncludeMem

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.