WCM_LockApList

構文


#include <nitroWiFi/wcm.h>

s32   WCM_LockApList( s32 lock );
				

説明

無線アクセスポイント自動探索中に発見された機器の情報を退避しておく内部リストバッファへの不定期な書き込みを許可もしくは禁止する同期関数です。
WM ライブラリから機器の発見が割り込みハンドラ内で通知されるため、WCM 内部リストバッファは意図しないタイミングで更新される可能性があります。 この現象を考慮すると、内部リストバッファから情報を読み出す際には割り込み禁止状態である、もしくは割り込みが発生してもリストが更新されない状態で ある必要があります。当関数では割り込みが発生してもリストが更新されない状態にしたり、通常通り更新される状態にしたりすることができます。
なお、内部リストバッファの更新許可・禁止設定は WCM_Init()を呼び出した時点で WCM_APLIST_UNLOCK に初期化されます。

引数

lock 内部リストバッファの更新許可・禁止を制御する値を指定します。
WCM_APLIST_LOCK を指定すると内部リストバッファの更新は禁止され、見つかった機器情報は破棄されるようになります。 WCM_APLIST_UNLOCK を指定すると内部リストバッファの更新は許可され、見つかった機器情報で随時更新されるようになります。 これら以外の値を指定すると、WCM_APLIST_LOCK が指定された場合と同様に更新は禁止されます。
< default は WCM_APLIST_UNLOCK です。>

返り値

当関数を呼び出す前のの更新許可・禁止設定を WCM_APLIST_LOCK もしくは WCM_APLIST_UNLOCK のいずれかの値で返します。 WCM ライブラリを初期化前に呼び出すと、WCM_APLIST_UNLOCK を返します。

参照

WCM_Init, WCMConfig, WCM_ClearApList, WCM_CountApList, WCM_PointApList, WCM_PointApListLinkLevel

履歴

2005/07/22 初版