DioDmTransferStart


Function

Starts the sampling/generating.

Format

Ret = DioDmTransferStart ( Id , Direction )

Parameters

Id [ VB.NET: Short ] [ C, C++: short ] [ C#: short ] [ Python: ctypes.c_short ]
Specify the device ID retrieved from DioInit.

Direction [ VB.NET: Short ] [ C, C++: short ] [ C#: short ] [ Python: ctypes.c_short ]
Set the transfer direction. Please set the transfer direction by the logical sum of the bits as follows.

Definition

Value

[Hex]

Description

DIODM_DIR_IN

0x1

Input

DIODM_DIR_OUT

0x2

Output

Return Value

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

Definition

Value

[Dec]

Description

DIO_ERR_SUCCESS

0

Normal completed.

DIO_ERR_SYS_RECOVERED_FROM_STANDBY

7

Execute DioResetDevice function because the device has recovered from standby mode.

DIO_ERR_DLL_INVALID_ID

10001

Invalid ID specified.

DIO_ERR_DLL_CALL_DRIVER

10002

Not call the driver (Failure on DEVICE I/O CONTROL).

DIO_ERR_SYS_NOT_SUPPORTED

20001

This board couldn't use this function.

DIO_ERR_SYS_IODIRECTION

20500

Direction value is out of range.

DIO_ERR_DM_SEQUENCE

21103

Procedure error of execution.

The others (See also: Details of Error Code)

Initial Value

None

Remarks

After this function is called, for the transfer, it starts at once when software start is specified as start condition, and starts when the start condition is met by specifying other condition as the start condition. The transfer start can be specified for input and output at the same time.

Please start the slave first when two or more boards are used synchronously.

An execution procedure error will occur if this function is called without setting data buffer with the DioDmSetBuffer function.

Example

Starts input transfer sampling.

VB.NET

Dim Ret As Integer
Ret = DioDmTransferStart ( Id , DIODM_DIR_IN )
 

C, C++

long Ret;
Ret = DioDmTransferStart ( Id , DIODM_DIR_IN );
 

C#

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

Python

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

See Also

DioDmTransferStop