Previous

Next

Function RTMapMem

Function RTMapMem maps physical to virtual addresses:

int RTMapMem(const void * Physical, 
             const void * Virtual, 
             unsigned     Bytes, 
             int          Access);

Parameters

Physical

Physical address to map.

Virtual

Virtual address to map to.

Bytes

Specifies the size of the address range.

Access

Specifies the desired access rights to the virtual address range. Values RT_PG_NOACCESS, RT_PG_SYSREAD, RT_PG_SYSREADWRITE, RT_PG_USERREAD, and RT_PG_USERREADWRITE are supported.

return value

In addition to the return codes documented for function RTReserveVirtualAddress, this function can return the following value:

If parameters Physical and Virtual are not page-aligned, their respective offsets from a page must be identical.

If paging is disabled, the function succeeds only if Physical == Virtual addresses. Otherwise, the page table is updated to map the given physical address to the requested virtual address.

This function performs no additional parameter validation. If the given virtual address is used by some other program entity or the physical address does not exist, the results will be unpredictable.

Function RTReleaseVirtualAddress

Function RTMapPhysMem