デバイスIDを取得して、デバイスへのアクセスを可能にします。
Ret = ZmInit ( DeviceName , Id )
DeviceName
[ C, C++: char * ] [ Python: ctypes.c_char_p ]
設定ツール(config)で設定したデバイス名を指定します。デバイス名は最大50文字(NULL含む)までです。
Id
[ C, C++: short * ] [ Python: ctypes.POINTER(ctypes.c_short) ]
デバイスIDを返します。以降の関数では、このデバイスIDを使用して、デバイスにアクセスします。
Ret [ C, C++: long ] [ Python: ctypes.c_long ]
定義 |
戻り値 |
内容 |
ZM_ERR_SUCCESS |
0 |
正常終了 |
ZM_ERR_INI_MEMORY |
3 |
メモリの割り当てに失敗しました。 |
ZM_ERR_INI_REGISTRY |
4 |
レジストリのアクセスに失敗しました。 |
ZM_ERR_INI_BOARD_ID |
5 |
czm.sysファイルが見つからないため初期化できません |
ZM_ERR_DLL_DEVICE_NAME |
10000 |
設定ファイルに登録されていないデバイス名が指定されました。 |
ZM_ERR_DLL_CALL_DRIVER |
10002 |
ドライバを呼び出せません(ioctlに失敗)。 |
ZM_ERR_DLL_CREATE_FILE |
10003 |
ファイルの作成に失敗しました(openに失敗)。 |
ZM_ERR_INFO_INVALID_DEVICE |
10050 |
指定したデバイス名称が見つかりません。スペルを確認してください。 |
ZM_ERR_INFO_NOT_FIND_DEVICE |
10051 |
利用可能なデバイスが見つかりません。 |
その他のエラー(参照:エラーコード詳細)
なし
デバイスIDを取得して、デバイスにアクセス可能にします。
以降の関数では、このデバイスIDを使用して、デバイスにアクセスします。
複数のデバイスをアクセスする場合、Idを格納する変数を複数用意してください。
ZmInitが正常終了した後、ZmExitが呼び出されるまで、各機能関数が使用できます。
ひとつのボードに対してアクセスできるのは16プロセスまでです。
同一プロセスで複数のスレッドからアクセスする場合には制限はありません。
デバイス"ZM000"を初期化して、Idを取得します。
C, C++ |
long Ret; |
Python |
Ret = ctypes.c_long() |