DWC_Init

構文

#include <dwc.h>
int DWC_Init(void *work);

引数

work 初期化用バッファのポインタ
32BytesアライメントされたDWC_INIT_WORK_SIZE分のバッファを指定してください。

返り値

DWC_INIT_RESULT_NOERROR 初期化成功。
DWC_INIT_RESULT_CREATE_USERID DS本体に仮のユーザIDを生成しました。
DWC_INIT_RESULT_DESTROY_USERID DS本体のユーザIDが破壊されていた可能性があるので、仮のユーザIDを生成しました。
DWC_INIT_RESULT_DESTROY_OTHER_SETTING DS本体の接続先設定が破壊された可能性があります。

説明

DWCライブラリを初期化する関数です。DS本体に保存するユーザIDのチェック・作成などを行います。DWCライブラリに含まれる他のAPIを呼び出す前に一回呼び出して下さい。

戻り値に応じて、適切なメッセージを表示するようにしてください。メッセージについては、「NitendoWi-FiConnectionプログラミングガイドライン」をご確認ください。

workに指定したバッファは、この関数終了後、解放しても構いません。
このバッファはARM7からアクセスするため、メインメモリ等のARM7からアクセス可能な領域に指定してください。

本関数を呼び出す前に、OS_Init関数を呼んでおく必要があります。
※OS_InitTick関数、OS_InitAlarm関数、RTC_Init関数がDWC_Init関数内で呼ばれます。

この関数は同期を取る為にPXI割り込みを待ちますので、PXI割り込みを禁止した状態で呼び出さないようにして下さい。

参照

DWC_CreateUserData

履歴

5.1
DWC_Init関数の使用前に呼ばなければいけない関数は、OS_Init関数だけである点について修正して記載

5.1pr2より前の変更履歴はこちら