CntGetPulseWidth


Function

Retrieves the one-shot pulse width. Supports multi-processing.

Format

Ret = CntGetPulseWidth ( Id , ChNo , PlsWidth )

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 retrieving.

PlsWidth [ VB.NET: Short ] [ C, C++: short * ] [ C#: out short ] [ Python: ctypes.POINTER(ctypes.c_short) ]
Specify the address of the variable that stores the coefficient of one-shot pulse width.
The following table shows the coefficients and pulse width.

Coefficient

Pulse Width

0h

0

1h

Approx. 409.6us

2h

Approx. 819.2us

3h

Approx. 1.23ms

4h

Approx. 4.92ms

5h

Approx. 10.24ms

6h

Approx. 20.07ms

7h

Approx. 29.9ms

8h

Approx. 40.14ms

9h

Approx. 49.97ms

Ah

Approx. 60.2ms

Bh

Approx. 70.04ms

Ch

Approx. 80.28ms

Dh

Approx. 90.11ms

Eh

Approx. 100.35ms

Fh

Approx. 104.45ms

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_DLL_BUFF_ADDRESS

10101

Invalid data buffer address.

CNT_ERR_SYS_BOARD_EXECUTING

20002

Cannot use while by another device works.

CNT_ERR_SYS_CH_NO

20201

Channel number is out of range.

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

Initial Value

0

Remarks

Retrieves the the one-shot pulse width of count match. For the device with sampling function, please use CntGetOutputHardwareEvent.

Example

Retrieves the one-shot pulse width of channel 0.

VB.NET

Dim Ret As Integer
Dim PlsWidth As Short
Ret = CntGetPulseWidth ( Id , 0 , PlsWidth )
 

C, C++

long Ret;
short PlsWidth;
Ret = CntGetPulseWidth ( Id , 0 , &PlsWidth );
 

C#

int Ret;
short PlsWidth;
Ret = cnt.GetPulseWidth ( Id , 0 , out PlsWidth );
 

Python

Ret = ctypes.c_long()
PlsWidth = ctypes.c_short()
Ret.value = ccnt.CntGetPulseWidth ( Id , 0 , ctypes.byref(PlsWidth) )
 

See Also

CntSetPulseWidth