デバイスファイルを作成し、以降デバイスを使用可能にします。
デバイスにアクセスするには、まずこの関数を実行する必要があります。
マルチプロセス対応関数です。
Ret = AioInit ( DeviceName , Id )
DeviceName
[ C, C++: char * ] [ Python: ctypes.c_char_p ]
設定ツール(コンフィグレーション)のプロパティページ、または設定ツールで設定したデバイス名を指定します。
Id
[ C, C++: short * ] [ Python: ctypes.POINTER(ctypes.c_short) ]
IDを受け取る変数のアドレスを指定します。
以降の関数は、この変数に格納された値を用いてアクセスできます。
Ret [ C, C++: long ] [ Python: ctypes.c_long ]
戻り値 |
内容 |
0 |
正常終了 |
2 |
割り込みルーチンの登録に失敗しました |
3 |
メモリの割り当てに失敗しました |
8 |
Caio.sysファイルが見つからないため初期化できません |
9 |
Caio.dllファイルのバージョン情報が取得できないため初期化できません |
10 |
Caio.sysファイルのバージョン情報が取得できないため初期化できません |
11 |
Caio.dllとCaio.sysのバージョン情報が一致しないため初期化できません |
10000 |
設定ツール(コンフィグレーション)ーまたは設定ツールに登録されていないデバイス名が指定されました |
10003 |
ファイルの作成に失敗しました 正常に起動していない場合、設定ツール(コンフィグレーション)からデバイスを削除し、再度デバイスの認識を行ってください。 |
10100 |
DeviceNameにデバイス名が格納されていません |
10101 |
IdのポインタがNULLです |
20000 |
オブジェクト作成用のメモリ確保に失敗しました |
20035 |
ファームウェアが旧バージョンです、ファームウェアのバージョンアップが必要です |
20036 |
ホストドライバが旧バージョンです、ホストドライバのバージョンアップが必要です |
20100 |
プロセスの数が上限に達しました |
この関数がプロセスで初めて実行された時には、内部のパラメータがすべてデフォルト値に設定されます。
デバイス内にレジスタを持つ場合はそのレジスタもデフォルト値に設定されます。
AioExit関数を実行せずに続けてAioInitを実行しても、内部のパラメータはデフォルトに戻りません。
内部パラメータをデフォルト値に戻すには、AioResetDeviceを使用します。
デバイスが動作中でもこの関数は実行できますが、デバイスの動作は停止しません。
「AIO000」のデバイス名で初期化を行います。
C, C++ |
long
Ret; |
Python |
Ret
= ctypes.c_long() |