コンテンツにスキップ
関数 > アナログ入力 >

YdxAiSetStopLevelVolt

機能

サンプリング停止条件( アナログ入力トリガ レベル比較 )を設定します。
しきい値は、電圧値で指定します。

書式

INT YdxAiSetStopLevelVolt(
    INT id,
    INT channel,
    float volt,
    INT mode
);

パラメータ

id

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

言語 C# VB(.NET2002以降) VB6.0 C++/CLI C/C++
int Integer Long int INT

channel

比較をするチャネルを指定します。
設定範囲は0~5、初期値は0です。

言語 C# VB(.NET2002以降) VB6.0 C++/CLI C/C++
int Integer Long int INT

volt

しきい値を指定します。
単位は「V」です。
設定範囲は-10~10 [V]、初期値は5 [V]です。

言語 C# VB(.NET2002以降) VB6.0 C++/CLI C/C++
float Single Single float FLOAT

mode

動作モードを指定します。

意味
0 立ち上がりエッジセンス(しきい値未満から、しきい値以上に変化した時に、条件成立)
1 立ち下がりエッジセンス(しきい値を超える値から、しきい値以下に変化した時に、条件成立)
2 両エッジセンス
3 ハイレベルセンス(しきい値以上の時に、条件成立。最初からしきい値以上だった場合も、条件成立)
4 ローレベルセンス(しきい値以下の時に、条件成立。最初からしきい値以下だった場合も、条件成立)

初期値は0です。

言語 C# VB(.NET2002以降) VB6.0 C++/CLI C/C++
int Integer Long int INT

戻り値

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

言語 C# VB(.NET2002以降) VB6.0 C++/CLI C/C++
int Integer Long int INT

備考

YdxAiSetStopCondition関数 で、サンプリング停止条件として「アナログ入力トリガ(レベル比較)」を選択した場合にのみ設定が有効になります。
サンプリング停止条件として「アナログ入力トリガ(レベル比較)」を選択しない場合は、本関数を実行する必要はありません。

しきい値は、バイナリ値に換算されて、内部に記憶されます。
本関数の実行後に 入力レンジが変更 されても再換算はおこなわれませんので、入力レンジを変更する場合は本関数の実行前におこなってください。

本関数は、アナログ入力が 動作中 には実行できません。

使用例

サンプリング停止条件(アナログ入力トリガ レベル比較)を設定します。
比較をするチャネルは1、しきい値は2.3V、動作モードはローレベルセンスに設定します。

C#

int result;
result = Ydx.AiSetStopLevelVolt(id, 1, 2.3F, 4);

VB(.NET2002以降)

Dim result As Integer
result = YdxAiSetStopLevelVolt(id, 1, 2.3, 4)

VB6.0

Dim result As Long
result = YdxAiSetStopLevelVolt(id, 1, 2.3, 4)

C++/CLI

int result;
result = YdxAiSetStopLevelVolt(id, 1, 2.3, 4);

C/C++

INT result;
result = YdxAiSetStopLevelVolt(id, 1, 2.3, 4);