ZmSingleCMeasure


機能

C(静電容量)の測定を1回だけ行います。

書式

Ret = ZmSingleCMeasure ( Id , ChannelNo , CValue , DValue , Status )

引数

Id [ VB.NET: Short ] [ C, C++: short ] [ C#: short ] [ Python: ctypes.c_short ]
ZmInitで取得したデバイスIDを指定します。

ChannelNo [ VB.NET: UShort ] [ C, C++: unsigned short ] [ C#: ushort ] [ Python: ctypes.c_ushort ]
チャネル番号を指定します。

CValue [ VB.NET: Single ] [ C, C++: float * ] [ C#: out float ] [ Python: ctypes.POINTER(ctypes.c_float) ]
静電容量を格納する変数アドレスを指定します。単位はF(ファラッド)です。

DValue [ VB.NET: Single ] [ C, C++: float * ] [ C#: out float ] [ Python: ctypes.POINTER(ctypes.c_float) ]
損失係数を格納する変数アドレスを指定します。

Status [ VB.NET: UInteger ] [ C, C++: unsigned long * ] [ C#: out uint ] [ Python: ctypes.POINTER(ctypes.c_ulong) ]
測定ステータスを格納する変数アドレスを指定します。

 Statusのビット番号

意味

16

測定前コンタクトチェック結果(L測定端側)

17

測定前コンタクトチェック結果(H測定端側)

18

測定後コンタクトチェック結果(L測定端側)

19

測定後コンタクトチェック結果(H測定端側)

24 - 25

等価回路モード
 1:直列回路
 2:並列回路

※未定義のビット番号は、未使用です。

戻り値

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

定義

戻り値
[Dec]

内容

ZM_ERR_SUCCESS

0

正常終了

ZM_ERR_SYS_CHANNEL_NO

20100

チャネル番号が設定可能範囲外です。

ZM_ERR_SYS_MEASURE_STOP

20116

測定が停止されました

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

初期値

なし

説明

C(静電容量)の測定を1回だけ行います。
測定するチャネルは指定した1CHのみになります。

本関数は測定完了まで処理が戻りません。
測定完了で処理が戻りますので、引数に入っている測定結果をご確認ください。

ZmResetDevice関数を実行すると測定は停止します。

測定ステータス内の等価回路モードについての詳細は、用語集「等価回路モード」を参照ください。
測定ステータス内のコンタクトチェックについての詳細は、用語集「コンタクトチェック」を参照ください。

使用例

ChannelNo = 1の静電容量、損失係数、および測定ステータスを取得します。

VB.NET

Dim Ret As Integer

Dim CValue As Single

Dim DValue As Single

Dim Status As UInteger

Ret = ZmSingleCMeasure ( Id , 1 , CValue , DValue , Status )
 

C, C++

long Ret;
float CValue;

float DValue;
unsigned long Status;
Ret = ZmSingleCMeasure ( Id , 1 , &CValue , &DValue , &Status );
 

C#

int Ret;

float CValue;
float DValue;

ulong Status;
Ret = zm.SingleCMeasure ( Id , 1 , out CValue , out DValue , out Status );
 

Python

Ret = ctypes.c_long()

CValue = ctypes.c_float()
DValue = ctypes.c_float()

Status = ctypes.c_ulong()
Ret.value = czm.ZmSingleCMeasure ( Id , 1 , ctypes.byref(CValue) , ctypes.byref(DValue) , ctypes.byref(Status) )
 

関連項目

ZmResetDevice