CntSetPresetRegister

Function

Sets the preset register. Supports multi-processing.

Format

Ret = CntSetPresetRegister ( Id , ChNo , PresetData , Reserved )

Parameters

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

ChNo [ VB.NET: Short ] [ C, C++: short ] [ C#: short ] [ Python: ctypes.c_short ]
Specify the channel number for setting.

PresetData [ VB.NET: Integer ] [ C, C++: unsigned long ] [ C#: uint ] [ Python: ctypes.c_ulong ]
Specify the preset value.
Allowable setting range:
0h <= PresetData <= FFFFFFFFh

Reserved [ VB.NET: Short ] [ C, C++: short ] [ C#: short ] [ Python: ctypes.c_short ]
Specify 0.

Return Value

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

Definition	Value	Description
CNT_ERR_SUCCESS	0	Normality completion
CNT_ERR_SYS_RECOVERED_FROM_STANDBY	7	Execute the function CntResetDevice to return from the standby mode.
CNT_ERR_DLL_INVALID_ID	10001	Invalid ID was specified.
CNT_ERR_DLL_CALL_DRIVER	10002	CNT driver can't be called (Failed in the device I/O control).
CNT_ERR_SYS_NOT_SUPPORTED	20001	This function can't be used by this device.
CNT_ERR_SYS_CH_NO	20201	Channel number is out of range.

The others: (See also: Details of Error Code)

Remarks

The value specified by this function is set in the preset register, and used when a given hardware condition occurs.
To set a counter to a given value immediately, use the CntPreset function rather than this function.

This PresetData is used for both CntSetInputHardwareEvent and CntSetCountMatchHardwareEvent.
You can not set the different PresetData for each hardware condition.

Example

Sets 2710h(10000) to the preset register of channel 0.

VB.NET	Dim Ret As Integer Ret = CntSetPresetRegister ( Id , 0 , &H2710 , 0 )
C, C++	long Ret; Ret = CntSetPresetRegister ( Id , 0 , 0x2710 , 0 );
C#	int Ret; Ret = cnt.SetPresetRegister ( Id , 0 , 0x2710 , 0 );
Python	Ret = ctypes.c_long() Ret.value = ccnt.CntSetPresetRegister ( Id , 0 , 0x2710 , 0 )