ZmInit


機能

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

書式

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

定義

戻り値
[Dec]

内容

ZM_ERR_SUCCESS

0

正常終了

ZM_ERR_INI_MEMORY

3

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

ZM_ERR_INI_REGISTRY

4

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

ZM_ERR_INI_NOT_FOUND_SYS_FILE

8

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

ZM_ERR_INI_DLL_FILE_VERSION

9

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

ZM_ERR_INI_SYS_FILE_VERSION

10

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

ZM_ERR_INI_NO_MATCH_DRV_VERSION

11

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

ZM_ERR_DLL_DEVICE_NAME

10000

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

ZM_ERR_DLL_CALL_DRIVER

10002

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

ZM_ERR_DLL_CREATE_FILE

10003

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

ZM_ERR_INFO_INVALID_DEVICE

10050

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

ZM_ERR_INFO_NOT_FIND_DEVICE

10051

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

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

初期値

なし

説明

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

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

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

使用例

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

VB.NET

Dim Ret As Integer
Dim Id As Short
Ret = ZmInit ( "ZM000" , Id )
 

C, C++

long Ret;
short Id;
Ret = ZmInit ( "ZM000" , &Id );
 

C#

int Ret;
short Id;
Ret = zm.Init ( "ZM000" , out Id );
 

Python

Ret = ctypes.c_long()
Id = ctypes.c_short()
Ret = czm.ZmInit ( "ZM000" , ctypes.byref(Id) )

関連項目

ZmExit