CntInit

機能

デバイスIDを取得して、デバイスをアクセス可能にします。

書式

Ret = CntInit ( DeviceName , Id )

引数

DeviceName [ C： char * ] [ Python： ctypes.c_char_p ]
設定ツール(config)で設定したデバイス名を指定します。
デバイス名は最大50文字(NULL含む)までです。

Id [ C： short * ] [ Python： ctypes.POINTER(ctypes.c_short) ]
デバイスIDを返します。以降の関数では、このデバイスIDを使用して、デバイスにアクセスします。

戻り値

Ret [ C： long ] [ Python： ctypes.c_long ]

定義	値	意味
CNT_ERR_SUCCESS	0	正常終了
CNT_ERR_INI_MEMORY	3	メモリの割り当てに失敗しました。
CNT_ERR_INI_REGISTRY	4	設定ファイルのアクセスに失敗しました。
CNT_ERR_INI_BOARD_ID	5	ボードIDが重複しています。
CNT_ERR_DLL_DEVICE_NAME	10000	設定ファイルに登録されていないデバイス名が指定されました。
CNT_ERR_DLL_CALL_DRIVER	10002	ドライバを呼び出せません(ioctlに失敗)。
CNT_ERR_DLL_CREATE_FILE	10003	ファイルの作成に失敗しました(openに失敗)。
CNT_ERR_INFO_INVALID_DEVICE	10050	指定したデバイス名称が見つかりません。スペルを確認してください。
CNT_ERR_INFO_NOT_FIND_DEVICE	10051	利用可能なデバイスが見つかりません。

その他のエラー(参照：エラーコード詳細)

初期値

なし

説明

デバイスIDを取得して、デバイスをアクセス可能にします。
以降の関数では、このデバイスIDを使用して、デバイスにアクセスします。
複数のデバイスをアクセスする場合、Idを格納する変数を複数用意してください。
CntInitが正常終了した後、CntExitが呼び出されるまで、各機能関数が使用できます。

使用例

デバイス"CNT000"を初期化して、Idを取得します。

C	Ret = CntInit("CNT000", &Id);
Python	Ret = ccnt.CntInit("CNT000", ctypes.byref(Id))