CanInit

機能

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

書式

Ret = CanInit ( 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 ]

定義

戻り値
[Dec]

内容

CAN_ERR_SUCCESS

0

正常終了

CAN_ERR_INI_MEMORY

3

メモリの割り当てに失敗しました。

CAN_ERR_INI_REGISTRY

4

レジストリのアクセスに失敗しました。

CAN_ERR_DLL_DEVICE_NAME

10000

設定ファイルに登録されていないデバイス名が指定されました。

CAN_ERR_DLL_CALL_DRIVER

10002

ドライバーを呼び出せません(ioctlに失敗)。

CAN_ERR_DLL_CREATE_FILE

10003

ファイルの作成に失敗しました(open失敗)。

CAN_ERR_INFO_INVALID_DEVICE

10050

指定したデバイス名称が見つかりません。スペルを確認してください。

CAN_ERR_INFO_NOT_FIND_DEVICE

10051

利用可能なデバイスが見つかりません。

その他のエラー（参照：エラーコード詳細）

初期値

なし

説明

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

1枚のデバイスに対してアクセスできるプロセスは1プロセスのみとなります。

使用例

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

C

long Ret;
short Id;
Ret = CanInit ( "CAN000" , &Id );
 

Python

Ret = ctypes.c_long()

Id = ctypes.c_short()
Ret.value = ccan.CanInit("CAN000",ctypes.byref(Id))
 

関連項目

CanExit