DioDmSetInternalClock

Function

Sets the clock value when internal clock is used.

Format

Ret = DioDmSetInternalClock ( Id , Direction , Clock , Unit )

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.

Definition

Value

[Dec]

Description

DIODM_DIR_IN

Input

DIODM_DIR_OUT

Output

Clock [ VB.NET: Integer ] [ C, C++: unsigned long ] [ C#: uint ] [ Python: ctypes.c_ulong ]
Set the clock value.
The clock value can be set in combination with the unit of the clock value within the following range.

Device Type	Available range
DIO-32DM3-PE	50nsec <= Clock <= 107sec(25nsec unit)
PIO-32DM(PCI) DIO-32DM-PE DIO-32DM2-PE	20nsec <= Clock <= 21sec(5nsec unit)

Unit [ VB.NET: Short ] [ C, C++: short ] [ C#: short ] [ Python: ctypes.c_short ]
The unit of the clock value

Definition	Value [Dec]	Description
DIODM_TIM_UNIT_S	1	1Sec unit
DIODM_TIM_UNIT_MS	2	1msec unit
DIODM_TIM_UNIT_US	3	1usec unit
DIODM_TIM_UNIT_NS	4	1nsec unit

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_SYS_CLOCK_VAL	21003	Clock value is outside the setting range.
DIO_ERR_SYS_CLOCK_UNIT	21004	Clock value unit is outside the setting range.

The others (See also: Details of Error Code)

Initial Value

The default is 1usec.

Remarks

It is necessary to set the clock value to make the application operation regular.

Example

Sets the internal clock to 10msec for input transfer.

VB.NET	Dim Ret As Integer Ret = DioDmSetInternalClock ( Id , DIODM_DIR_IN , 10 , DIODM_TIM_UNIT_MS )
C, C++	long Ret; Ret = DioDmSetInternalClock ( Id , DIODM_DIR_IN , 10 , DIODM_TIM_UNIT_MS );
C#	int Ret; Ret = dio.DmSetInternalClock ( Id , (short)CdioConst.DIODM_DIR_IN , 10 , (short)CdioConst.DIODM_TIM_UNIT_MS );
Python	Ret = ctypes.c_long() Ret.value = cdio.DioDmSetInternalClock ( Id , cdio.DIODM_DIR_IN , 10 , cdio.DIODM_TIM_UNIT_MS )