WM_EndMP

構文

#include <nitro/wm.h>

WMErrCode WM_EndMP( WMCallbackFunc callback );

引数

callback 非同期処理が完了した時に呼び出されるコールバック関数を指定します。
このコールバックは割り込みハンドラ内から呼び出されます。

返り値

WMErrCode列挙型の処理結果を返します。

説明

MPモードを終了します。WMステートがMP_PARENTステート、もしくはMP_CHILDステートの場合に実行可能です。 APIの戻り値がWM_ERRCODE_OPERATINGであった場合、MPモード終了処理が完了した後にコールバックが発生します。 WMステートはそれぞれPARENTステート、もしくはCHILDステートに戻ります。

MP通信を行う子機では、WM_EndMP( ) を呼び出すと、それ以降は親機から通信に対してNull応答を返しつづけます。 この状態が親機のWM_SetLifeTime( ) で設定されたMP通信ライフタイムを超えると親機から切断されます。 また、この状態の子機に対して親機側からMP通信でデータを送った場合、親機は送信成功の通知を受けますが、子機は受信したデータを全て捨ててしまいますので注意してください。

参照

WM_StartMP, WM_StartMPEx, WM_SetMPDataToPort, WM_SetPortCallback

履歴

2005/06/08 コールバックが割り込みハンドラから呼び出される旨を補足
2004/11/09 Null応答に関する説明を追記
2004/10/22 返り値の型を変更
2004/09/25 説明の加筆・修正
2004/07/29 説明の追加等
2004/07/23 初版