osPfsGetLabel.htm 2.61 KB

Raw Blame History Permalink

<HTML>
<HEAD>
<TITLE>HTML 文書</TITLE>
<META NAME="GENERATOR" CONTENT="mitu">
</HEAD>

<BODY>

<P>
<B><FONT FACE="Arial">osPfsGetLabel(3P)<BR>
</FONT></B>
<P>
<B>関数名<BR>
</B>
<P>
osPfsGetLabel
<P>
→ コントローラパックのラベルの読み込み<BR>

<P>
<B>構文<BR>
</B>
<P>
#include &lt;ultra64.h&gt;<BR>

<P>
<B>s32 osPfsGetLabel(OSPfs *pfs,  u8 *label,  int *length);<BR></B>

<P>
<B>説明<BR>
</B>
<P>
コントローラパックにはBLOCKSIZE（32バイト）のラベル領域が用意されています。このラベルを読み込むための関数がosPfsGetLabelです。ただ、このラベル領域の仕様は現在未定義となっています。そのため、今のところこの関数は使用なさらないようお願いします。
<BR>
<P>
OSPfsハンドルはosPfsInitPakから返されたハンドルでなければなりません。このハンドルの作成方法の詳細については<A HREF="osPfsInitPak.htm">osPfsInitPak</A>,(3P)を参照してください。
<BR>
<P>
labelで指し示される領域は、ラベルのデータが格納されるため、BLOCKSIZE分の領域を確保しておく必要があります。
<BR>
<P>
呼び出しが成功すれば、返り値として0が返され、また、ラベルの長さがlengthに返されます。エラーが発生した場合には、以下に示すエラーコードが返されます。
<BR>
<P>
関数の呼び出しに成功すれば、返り値として0が返されます。エラーが発生した場合には、以下に示すエラーコードのいずれかが返されます。
<BR>
<P>
<B>PFS_ERR_NOPACK</B>
<P>
指定したコントローラにコントローラパックが挿し込まれていません。あるいは、コントローラが挿し込まれていないなど、何らかのPIfエラーが発生しました。このどちらであるのかを調べる場合には、<A HREF="osContStartQuery.htm">osContStartQuery</A>,(3P)＆<A HREF="osContGetQuery.htm">osContGetQuery</A>,(3P)などを使用してください。
<BR>
<P>
<B>PFS_ERR_NEW_PACK</B>
<P>
コントローラパックが別のコントローラパックに挿し替わっています。このまま、このコントローラパックを使用する場合には、<A HREF="osPfsInitPak.htm">osPfsInitPak</A>,(3P)を呼び出して、コントローラパックを初期化してください。
<BR>
<P>
<B>PFS_ERR_CONTRFAIL</B>
<P>
コントローラとのデータ転送の失敗です。関数の内部では、転送エラーが発生した場合、最大3回転送のやり直しを行っています。そのため、このエラーが発生することはあまりありません。このエラーが返る場合、コントローラが正しく接続されていないか、あるいは、コントローラパックかコントローラコネクタに異常がある可能性があります。
<BR>
<P>
<B>参照<BR>
</B>
<A HREF="osContInit.htm">osContInit</A>(3P),
<A HREF="osContStartQuery.htm">osContStartQuery</A>(3P),
<A HREF="osContGetQuery.htm">osContGetQuery</A>(3P),
<A HREF="osPfsChecker.htm">osPfsChecker</A>(3P),
<A HREF="osPfsInitPak.htm">osPfsInitPak</A>(3P),
<A HREF="osPfsIsPlug.htm">osPfsIsPlug</A>(3P),
<A HREF="osPfsSetLabel.htm">osPfsSetLabel</A>(3P),
</BODY>

</HTML>