osReadHost.htm 2.13 KB

Raw Blame History Permalink

<HTML>

<HEAD>

<TITLE>HTML 文書</TITLE>

<META NAME="GENERATOR" CONTENT="Internet Assistant for Microsoft Word 2.0j">
</HEAD>

<BODY>

<P>
<B><FONT FACE="Arial">osReadHost(3P) <BR>
</FONT></B>
<P>
<B>関数名<BR>
</B>
<P>
osReadHost, osWriteHost, osTestHost
<P>
→ ホストとDRAM間の転送データ <BR>

<P>
<B>構文<BR>
</B>
<P>
#include &lt;ultra64.h&gt;
<P>
<B>void osReadHost(void *vAddr, s32 nbytes);</B>
<P>
void osWriteHost(void *vAddr, s32 nbytes);
<P>
s32 osTestHost(void);<BR>

<P>
<B>説明<BR>
</B>
<P>
これらのルーチンはゲームがホストアプリケーションからデータの受け渡しをすることを許可します｡それらはホスト側の<A HREF="../uh/uhOpenGame.htm">uhOpenGame</A>(3P)中に記述されたルーチンと一緒に動作します｡
<BR>
</FONT>
<P>
<B>osReadHost</B>ルーチンはホストからnbytesのデータを受け取るゲーム側の接続をセットアップし､そしてそのデータをアドレスvAddrで始まるDRAMにコピーします｡正確な同期を行うために､uhWriteGameと確実に同じバイト数にゲーム側を合わせてください｡もしホストがライトを実行する前にゲーム側からリードを試みると､ゲームスレッドはブロックします｡逆に言えば､ゲームがリードを実行する前にホストからライトを試みれば､ホストプロセスはブロックします｡両方の側が正確に対応している手続きのコールを行ったときは､転送は実行され､ブロック中の側は再開します｡
<BR>
</FONT>
<P>
osWriteHostルーチンはゲームが開始するvAddrからnbytesのデータをホストにコピーします｡こういったケースでは､操作を行う際にホスト側でuhReadGame手続きと同じバイトのカウントに合わせておいてください｡上記と同様､ホストとゲームの両方が通信を行うまでブロックします｡
<BR>

<P>
DRAM仮想アドレスvAddrは8byte(64bit)整列であるべきですが、ホスト側の制約によって､転送サイズnbytesは4の倍数にしてください｡加えて､rmonがロウレベルの同期を管理するために動作することも必要になります。
<BR>

<P>
このosTestHostルーチンはサポート対象外です。
<P>
このリリース以降、osAckRamromReadとosAckRamromWriteルーチンは、uhReadRamromとuhWriteRamromを関連付けのために使用されます。必要はないですが、ダミーとしてライブラリに残しました。
<BR>

<P>
正確な開始方法とホストからの接続の使用方法については<A HREF="../uh/uhOpenGame.htm">uhOpenGame</A>(3P)を参照してください｡
<BR>
</FONT>
</BODY>

</HTML>