関数 > デジタル入力 >

YdxDiGetStatus¶

機能¶

現在の状態を取得します。

書式¶

INT YdxDiGetStatus(
    INT id,
    INT* status,
    INT* sampleCount,
    INT* repeatCount
);

パラメータ¶

id¶

YdxOpen関数で取得したIDを指定します。

言語	C#	VB（.NET2002以降）	VB6.0	C++/CLI	C/C++
型	int	Integer	Long	int	INT

status¶

ステータスを格納する変数へのポインタを指定します。
ビットごとに意味を持っていて、論理和された結果が格納されます。

値	定義名	ステータス
00000001h	YDX_STATUS_BUSY	動作中動作が開始されると（ YdxDiStart関数が実行されると）オンになります。動作が終了するとオフに戻ります。
00000002h	YDX_STATUS_SAMPLE_NUM	監視サンプル数データバッファのデータが、監視サンプル数以上になった場合にオンになります。監視サンプル数は、YdxDiSetCheckSampleNum関数で変更できます。
00000004h	YDX_STATUS_START_TRIG	開始条件成立済み開始条件が成立するとオンになります。リピートにより再び開始条件待ちになるとオフに戻ります。
00000008h	YDX_STATUS_STOP_TRIG	停止条件成立済み停止条件が成立するとオンになります。リピートにより開始条件が成立するとオフに戻ります。
00010000h	YDX_STATUS_SAMPLE_CLOCK_ERR	サンプリングクロックエラー発生外部クロック使用時に、周期が早すぎる外部クロックが入力された場合にオンになります。外部クロックの周期に問題がないか、チャタリング・ノイズが含まれていないかを確認してください。
00020000h	YDX_STATUS_OVERRUN_ERR	オーバランエラー発生データバッファがFIFOバッファ形式に設定されている場合に、データバッファ容量を超えてサンプリングがおこなわれた場合にオンになります。定期的に YdxDiGetData関数を使用してデータを読み出して、データバッファが満杯にならないようにしてください。
00040000h	YDX_STATUS_HARDWARE_ERR	ハードウェアエラー発生ユニット内部回路に異常が検出した場合にオンになります。通常ありえませんが、もし発生した場合は、どのような状況で発生したかを弊社サポートまでご連絡ください。
00080000h	YDX_STATUS_COMMUNICATE_ERR	通信エラー発生 USB通信に異常が検出された場合にオンになります。近くにノイズ要因がないか確認してください。確認しても問題が見当たらない場合は、どのような状況で発生したかを弊社サポートまでご連絡ください。

言語	C#	VB（.NET2002以降）	VB6.0	C++/CLI	C/C++
型	out int	Integer	Long	int*	INT*

sampleCount¶

サンプル数を格納する変数へのポインタを指定します。

データバッファがFIFOバッファ形式に設定されている場合、データバッファに記憶されてまだ読み出されていないサンプル数が格納されます。
データバッファがリングバッファ形式に設定されている場合、データバッファに記憶されているサンプル数が格納されます。

言語	C#	VB（.NET2002以降）	VB6.0	C++/CLI	C/C++
型	out int	Integer	Long	int*	INT*

repeatCount¶

動作済みリピート回数を格納する変数へのポインタを指定します。

2,147,483,647回を超えた場合、0に戻ってカウントされます。

言語	C#	VB（.NET2002以降）	VB6.0	C++/CLI	C/C++
型	out int	Integer	Long	int*	INT*

戻り値¶

関数が正常に終了した場合は、0（YDX_RESULT_SUCCESS）が返ります。
正常に終了しなかった場合は、0以外が返ります。
詳細は、戻り値一覧を参照してください。

言語	C#	VB（.NET2002以降）	VB6.0	C++/CLI	C/C++
型	int	Integer	Long	int	INT

使用例¶

現在の状態を取得します。

C#¶

int result;
int status;
int sampleCount;
int repeatCount;
result = Ydx.DiGetStatus(id, out status, out sampleCount, out repeatCount);

VB（.NET2002以降）¶

Dim result As Integer
Dim status As Integer
Dim sampleCount1 As Integer
Dim repeatCount As Integer
result = YdxDiGetStatus(id, status, sampleCount, repeatCount)

VB6.0¶

Dim result As Long
Dim status As Long
Dim sampleCount1 As Long
Dim repeatCount As Long
result = YdxDiGetStatus(id, status, sampleCount, repeatCount)

C++/CLI¶

int result;
int status;
int sampleCount;
int repeatCount;
result = YdxDiGetStatus(id, &status, &sampleCount, &repeatCount);

C/C++¶

INT result;
INT status;
INT sampleCount;
INT repeatCount;
result = YdxDiGetStatus(id, &status, &sampleCount, &repeatCount);