 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 DriveNintendo® Confidential |
|
|
|
|
|
osWriteHost
Format#include <ultra64.h>
void osWriteHost(void *vAddr, s32 nbytes);
Arguments
- vAddr is the pointer to the DRAM virtual address; it should be 8-byte (64-bit) aligned
- nbytes is the transfer size; due to a host restriction, it must be a multiple of 4
The osReadHost, osWriteHost, osTestHost, osAckRamromRead, and osAckRamromWrite routines allow the game to transfer data back and forth from a host application to/from RDRAM. They work in concert with the host-to-target IO functions (uhOpenGame, uhCloseGame, uhReadGame, uhWriteGame, uhReadRamrom, and uhWriteRamrom) on the host side.
The osWriteHost routine attempts to copy nbytes of data from the game beginning at vAddr to the host. In this case, the operation should be paired on the host side with the uhReadGame function using the same byte count. Either the host or the game will block until the rendezvous is complete.
Note that the rmon debugging program must be running to manage the low-level synchronization.
See uhOpenGame for an example that shows how to correctly initiate and use a connection from the host.
See Also
osReadHost
osTestHost
osAckRamromRead
osAckRamromWrite
uhReadGame uhOpenGame
uhCloseGame
uhReadGame
uhWriteGame
uhReadRamrom
uhWriteRamrom
|
|
|
|
|
|
|
 |
 |
 |
 |
 |
 |
 |
 |
 |
 |
 |
 |
|
|
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 |