This API translates an effective address (virtual) to the corresponding physical address.
All addresses used within application programs are "Effective Addresses", to use the PowerPC architecture terminology. Roughly speaking, these are vitual addresses.
Under normal circumstances, a program will have no need to know the underlying physical addresses. This API is provided to cover for the exceptional cases where perhaps some hardware device must access memory directly at its physical address.
|virtAddr ||Object's virtual address whose physical address is desired |
|lenPtr ||Optional output parameter is a pointer to location that will receive the length of the contiguous physical memory in bytes which starts at 'virtAddr'. This parameter can be set to NULL if this output is not desired. |
- Corresponding physical address, else NO_PHY_ADDRESS if
virtAddr does not map to any physical address. That is to say that
virtAddr does not lie in the system's current effective address space.
- The API does not exists in the SC1x, SC2x and SC1x3 C-Library.
- SC2x3 V1.00 - CLIB V1.00