PtQueryDeviceName

■機能

使用可能なデバイスの一覧を取得します。

 

■書式

Ret = PtQueryDeviceName(Index, GroupID, UnitID, DevicID, DeviceName, Device)

 

■引数

Index [VB.NET:Short C,C++:short C#:short]

最初に0を指定し、以降+1づつ値を指定します。

 

GroupID[VB.NET:Short C,C++:short C#:ref short]

グループIDを返します。

 

UnitID[VB:Short C,C++:short C#:ref short]

ユニットIDを返します。

 

DeviceID[VB.NET:Short C,C++:short C#:ref short]

デバイスIDを返します。

 

DeviceName [VB.NET:StringBuilder C,C++:char* C#:StringBuilder]

デバイス名を返します。(例:"PT00")

 

Device [VB.NET:StringBuilder C,C++:char* C#:StringBuilder]

デバイス名称を返します。(例:"PTI-4(FIT)GY")

 

■戻り値

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

定義

意味

PT_ERR_SUCCESS

0

正常終了

PT_ERR_INI_REGISTRY

4

設定ファイルのアクセスに失敗しました。

PT_ERR_INFO_NOT_FIND_DEVICE

10051

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

PT_ERR_DLL_BUFF_ADDRESS

10100

データバッファアドレスが不正です。

 

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

 

■説明

使用するデバイスを選択させるような、汎用的なアプリケーションを作成する場合に利用できます。

Indexを0から順に+1していき、エラーになるまで処理を繰り返してください。

 

■使用例

VB.NET       Ret = PtQueryDeviceName (0, GroupID, UnitID, DeviceID, DeviceName , Device )

C,C++         Ret = PtQueryDeviceName (0, &GroupID, &UnitID, &DeviceID, DeviceName , Device );

C#              Ret = ccappt.PtQueryDeviceName (0 , ref GroupID, ref UnitID, ref DeviceID, ref DeviceName , ref Device );

 

■関連項目

なし