DioInit

機能

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

書式

Ret = DioInit ( 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]	意味
DIO_ERR_SUCCESS	0	正常終了
DIO_ERR_INI_MEMORY	3	メモリの割り当てに失敗しました。
DIO_ERR_INI_REGISTRY	4	レジストリのアクセスに失敗しました。
DIO_ERR_INI_BOARD_ID	5	ボードIDが重複しています。
DIO_ERR_DLL_DEVICE_NAME	10000	設定ファイルに登録されていないデバイス名が指定されました。
DIO_ERR_DLL_CALL_DRIVER	10002	ドライバを呼び出せません(ioctlに失敗)。
DIO_ERR_DLL_CREATE_FILE	10003	ファイルの作成に失敗しました(openに失敗)。
DIO_ERR_INFO_INVALID_DEVICE	10050	指定したデバイス名称が見つかりません。スペルを確認してください。
DIO_ERR_INFO_NOT_FIND_DEVICE	10051	利用可能なデバイスが見つかりません。

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

初期値

なし

説明

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

使用例

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

C	Ret = DioInit("DIO000", &Id);
Python	Ret = cdio.DioInit("DIO000",ctypes.byref(Id))

制限事項

ひとつのボードに対してアクセスできるのは16プロセスまでです。 BusMaster対応ボードの場合は1プロセスのみアクセスできます。同一プロセスで複数のスレッドからアクセスする場合には制限はありません。