DioDmSetStopNumber


機能

ストップ条件として、停止個数を設定します。

書式

Ret = DioDmSetStopNumber ( Id , Direction , StopNumber )

引数

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

Direction [ VB.NET: Short ] [ C, C++: short ] [ C#: short ] [ Python: ctypes.c_short ]
転送方向を設定してください。

定義

[Dec]

意味

DIODM_DIR_IN

1

入力

DIODM_DIR_OUT

2

出力

StopNumber [ VB.NET: Integer ] [ C, C++: unsigned long ] [ C#: uint ] [ Python: ctypes.c_ulong ]
停止個数を指定してください。

デバイス名称

設定可能範囲

DIO-32DM3-PE

1 ≦StopNum ≦536,870,912(20000000H)

PIO-32DM(PCI)
DIO-32DM-PE
DIO-32DM2-PE

1 ≦StopNum ≦16,777,215(FFFFFFH)

戻り値

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

定義

[Dec]

意味

DIO_ERR_SUCCESS

0

正常終了

DIO_ERR_SYS_RECOVERED_FROM_STANDBY

7

スタンバイモードから復帰したため、DioResetDevice関数を実行してください

DIO_ERR_DLL_INVALID_ID

10001

無効なIDが指定されました。

DIO_ERR_DLL_CALL_DRIVER

10002

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

DIO_ERR_SYS_NOT_SUPPORTED

20001

このデバイスではこの関数は使用できません。

DIO_ERR_SYS_IODIRECTION

20500

入出力方向が設定範囲外です。

DIO_ERR_SYS_STOP_NUM

21006

停止個数が設定範囲外です。

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

初期値

デフォルトは1000です。

説明

ストップ条件として個数停止を指定した場合は必ず設定してください。
出力の場合には、この関数で指定する停止個数よりもバッファサイズを1以上大きく設定する必要があります。(DioDmSetBuffer)
停止個数とバッファサイズが同じ場合、DIODM_STATUS_FIFOEMPTYのエラーが発生します。(DioDmGetStatus 参照)

使用例

入力転送の停止個数を10000回に設定します。

VB.NET

Dim Ret As Integer
Ret = DioDmSetStopNumber ( Id , DIODM_DIR_IN , 10000 )
 

C, C++

long Ret;
Ret = DioDmSetStopNumber ( Id , DIODM_DIR_IN , 10000 );
 

C#

int Ret;
Ret = dio.DmSetStopNumber ( Id , (short)CdioConst.DIODM_DIR_IN , 10000 );
 

Python

Ret = ctypes.c_long()
Ret.value = cdio.DioDmSetStopNumber ( Id , cdio.DIODM_DIR_IN , 10000 )
 

関連項目

DioDmSetStopTrigger