初期化と終了処理

初期化と終了処理は、全てのプログラミングで必要となる共通の処理です。
初期化処理はSsiInit関数で行います。
この関数はドライバファイルの作成や必要なメモリの確保などを行います。

SsiInit関数には引数が２つあります。
第１引数はデバイス名です。
デバイス名は設定ツール(コンフィグレーション)で登録した”SSI000”などの文字列になります。

第２引数はIDです。
IDはドライバより渡される数字で、以降の関数を使用するにはこのIDが必要になります。

関数が正常終了すると、戻り値(Ret)にが０が返ります。
関数の実行に失敗した場合、０以外の値が返ります。

終了処理はSsiExit関数で行います。
この関数はデバイス、ドライバ動作を停止し、メモリ、スレッドなどの使用していた全てのリソースを開放します。
アプリケーションは必ずこの関数を実行してから終了してください。
そうしないと、ドライバが使用していたリソースが開放されないまま残ることがあります。

Cでのプログラミング例

デバイス"SSI000"に対して、初期化と終了処理を行います。

long Ret;
short Id;

Ret = SsiInit( "SSI000" , &Id );
if(Ret != 0){
   printf("SsiInitでエラーが発生しました %d\n", Ret);
}

Ret = SsiExit( Id );
if(Ret != 0){
   printf("SsiExitでエラーが発生しました %d\n", Ret);
}

Pythonでのプログラミング例

デバイス"SSI000"に対して、初期化と終了処理を行います。

Ret = ctypes.c_long()

Id = ctypes.c_short()

Ret.value = cssi.SsiInit ( b"SSI000" , ctypes.byref(Id))

if Ret.value != 0:

    print(f"SsiInitでエラーが発生しました {Ret.value}\n")

Ret.value = cssi.SsiExit ( Id )

if Ret.value != 0:

    print(f"SsiExitでエラーが発生しました {Ret.value}\n")