WM_Disconnect

構文

#include <nitro/wm.h>

WMErrCode WM_Disconnect( WMCallbackFunc callback , u16 aid );

引数

callback 非同期処理が完了した時に呼び出されるコールバック関数を指定します。
このコールバックは割り込みハンドラ内から呼び出されます。
aid 切断する通信相手のAIDを指定します。
親機の場合には 1 〜 15 の値を指定可能であり、対応するAIDを割り当てられている子機を個別に切断します。
子機の場合には 0 ( 親機のAID ) を指定して下さい。

返り値

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

説明

指定した機器との接続を切断します。WMのステートが接続済み以上の状態(PARENT、MP_PARENT、CHILD、MP_CHILD、DCF_CHILD 各ステート)でのみ実行可能です。 APIの戻り値がWM_ERRCODE_OPERATINGであった場合、切断処理が完了した後にコールバックが発生します。
子機として接続を切断した場合には通信が終了し、WMのステートはIDLEステートに戻ります。 親機の場合には指定した子機との接続を切断するだけで、通信は継続されます。

参照

WM_StartParent, WM_StartConnect, WM_DisconnectChildren

履歴

2005/06/08 コールバックが割り込みハンドラから呼び出される旨を補足
2005/03/02 aid引数について説明追記
2004/10/22 返り値の型を変更
2004/07/29 説明の追加等
2004/07/23 初版