CntInit


機能

デバイスIDを取得して、デバイスにアクセス可能にします。マルチプロセス対応関数です。

書式

Ret = CntInit ( DeviceName , Id )

引数

DeviceName [ VB.NET: String ] [ C, C++: char * ] [ C#: string ] [ Python: ctypes.c_char_p ]
デバイスマネージャで設定したデバイス名を指定します。

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

戻り値

Ret [ VB.NET: Integer ] [ C, C++: long ] [ C#: int ] [ Python: ctypes.c_long ]

定義

意味

CNT_ERR_SUCCESS

0

正常終了

CNT_ERR_INI_MEMORY

3

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

CNT_ERR_INI_REGISTRY

4

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

CNT_ERR_SYS_RECOVERED_FROM_STANDBY

7

スタンバイモードから復帰したため、CntResetDevice関数を実行してください

CNT_ERR_INI_NOT_FOUND_SYS_FILE

8

ccnt.sysファイルが見つからないため初期化できません

CNT_ERR_INI_DLL_FILE_VERSION

9

ccnt.dllファイルのバージョン情報が取得できないため初期化できません

CNT_ERR_INI_SYS_FILE_VERSION

10

ccnt.sysファイルのバージョン情報が取得できないため初期化できません

CNT_ERR_INI_NO_MATCH_DRV_VERSION

11

ccnt.dllとccnt.sysのバージョン情報が一致しないため初期化できません

CNT_ERR_DLL_DEVICE_NAME

10000

デバイスマネージャーに登録されていないデバイス名が指定されました

CNT_ERR_DLL_CALL_DRIVER

10002

ドライバーを呼び出せません。(デバイスI/Oコントロールに失敗)

CNT_ERR_DLL_CREATE_FILE

10003

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

CNT_ERR_INFO_INVALID_DEVICE

10050

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

CNT_ERR_INFO_NOT_FIND_DEVICE

10051

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

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

初期値

なし

説明

デバイスIDを取得して、デバイスにアクセス可能にします。以降の関数では、このデバイスIDを使用して、デバイスにアクセスします。

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

1枚のデバイスに対してアクセスできるプロセス数は、デバイスによって異なります。詳細は、利用可能プロセス数の一覧を参照ください。

お客様のアプリケーションを起動するまえに、必ずデバイスを接続してください。
CntInit関数が正常終了できないことがあります。

使用例

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

VB.NET

Dim Ret As Integer
Dim Id As Short
Ret = CntInit ( "CNT000" , Id )
 

C, C++

long Ret;
short Id;
Ret = CntInit ( "CNT000" , &Id );
 

C#
 

int Ret;
short Id;
Ret = cnt.Init ( "CNT000" , out Id );
 

Python

Ret = ctypes.c_long()
Id = ctypes.c_short()
Ret.value = ccnt.CntInit ( "CNT000" , ctypes.byref(Id) )
 

関連項目

CntExit