N64® Functions Menu

al - Audio Library Functions
gDP - DP GBI Macros
gdSP - General GBI Macros
gSP - SP GBI Macros
gt - Turbo Microcode RDP
gu - Graphics Utilities
Math - Math Functions
nuSys - NuSystem
os - N64 Operating System
sp - Sprite Library Functions
uh - Host to Target IO
64DD - N64 Disk Drive

Nintendo® Confidential

   

osVirtualToPhysical osPhysicalToVirtual

Format
#include <ultra64.h>

u32 osVirtualToPhysical(void *vaddr);
void *osPhysicalToVirtual(void *paddr);


What These Functions Do
The osVirtualToPhysical and osPhysicalToVirtual functions translate a CPU virtual address to a physical memory address and vice versa.

The osVirtualToPhysical routine translates an arbitrary CPU virtual address to its physical address, if such a translation exists. If the address is a KSEG0 or a KSEG1 address, the returned result is equivalent to that of OS_K0_TO_PHYSICAL or OS_K1_TO_PHYSICAL, respectively. Otherwise the address is part of a translation lookaside buffer (TLB) mapped address space (KUSEG, KSSEG, or KSEG3), and the TLB is probed to determine if a mapping exists for the given address. If so, the corresponding physical address is returned; otherwise, -1 is returned.

The osPhysicalToVirtual routine is a function version of OS_PHYSICAL_TO_K0, and thus returns the direct mapped, cached (KSEG0) address corresponding to the address pointed to by the paddr argument.

See Also
osMapTLB
OS_K0_TO_PHYSICAL
OS_K1_TO_PHYSICAL
OS_PHYSICAL_TO_K0
OS_PHYSICAL_TO_K1



Nintendo® Confidential

Warning: all information in this document is confidential and covered by a non-disclosure agreement. You are responsible for keeping this information confidential and protected. Nintendo will vigorously enforce this responsibility.


Copyright © 1998
Nintendo of America Inc. All rights reserved
Nintendo and N64 are registered trademarks of Nintendo
Last updated January 1998