xPCI-3009 API
PCI-3009 incremental counter read functions

Functions

_INT_ i_PCI3009_LatchCounter (DWORD_ dw_BoardHandle, BYTE_ b_LatchReg)
 
_INT_ i_PCI3009_ReadLatchRegisterStatus (DWORD_ dw_BoardHandle, BYTE_ b_LatchReg, PBYTE_ pb_LatchStatus)
 
_INT_ i_PCI3009_ReadLatchRegisterValue (DWORD_ dw_BoardHandle, BYTE_ b_LatchReg, PDWORD_ pdw_LatchValue)
 
_INT_ i_PCI3009_EnableLatchInterrupt (DWORD_ dw_BoardHandle)
 
_INT_ i_PCI3009_DisableLatchInterrupt (DWORD_ dw_BoardHandle)
 
_INT_ i_PCI3009_Read16BitCounterValue (DWORD_ dw_BoardHandle, BYTE_ b_SelectedCounter, PWORD_ pw_CounterValue)
 
_INT_ i_PCI3009_Read32BitCounterValue (DWORD_ dw_BoardHandle, PDWORD_ pdw_CounterValue)
 

Detailed Description

Function Documentation

_INT_ i_PCI3009_LatchCounter ( DWORD_  dw_BoardHandle,
BYTE_  b_LatchReg 
)

Latch the courant value in to the selected latch register (b_LatchReg).

Parameters
[in]dw_BoardHandle: Handle of board PCI-3009
[in]b_LatchReg: Selected latch register
0 : for the first latch register
1 : for the second latch register
Returns
0: No error
-1: The handle parameter of the board is wrong
-2: The module is not a counter module
-3: Counter not initialised see function "i_PCI3009_InitCounter"
-4: The selected latch register parameter is wrong
_INT_ i_PCI3009_ReadLatchRegisterStatus ( DWORD_  dw_BoardHandle,
BYTE_  b_LatchReg,
PBYTE_  pb_LatchStatus 
)

Read the latch register status from selected latch register (b_LatchReg).

Parameters
[in]dw_BoardHandle: Handle of board PCI-3009
[in]b_LatchReg: Selected latch register
0 : for the first latch register
1 : for the second latch register
[out]pb_LatchStatus: Latch register status.
0 : No latch occur
1 : A software latch occur
2 : A hardware latch occur
3 : A software and hardware latch occur
Returns
0: No error
-1: The handle parameter of the board is wrong
-2: The module is not a counter module
-3: Counter not initialised see function "i_PCI3009_InitCounter"
-4: The selected latch register parameter is wrong
_INT_ i_PCI3009_ReadLatchRegisterValue ( DWORD_  dw_BoardHandle,
BYTE_  b_LatchReg,
PDWORD_  pdw_LatchValue 
)

Read the latch register value from selected latch register (b_LatchReg).

Parameters
[in]dw_BoardHandle: Handle of board PCI-3009
[in]b_LatchReg: Selected latch register 0 : for the first latch register
1 : for the second latch register
[out]pdw_LatchValue: Latch register value
Returns
0: No error
-1: The handle parameter of the board is wrong
-2: The module is not a counter module
-3: Counter not initialised see function "i_PCI3009_InitCounter"
-4: The selected latch register parameter is wrong
_INT_ i_PCI3009_EnableLatchInterrupt ( DWORD_  dw_BoardHandle)

Enable the latch interrupt. Each software or hardware latch occur a interrupt.

Parameters
[in]dw_BoardHandle: Handle of board PCI-3009
Returns
0: No error
-1: The handle parameter of the board is wrong
-2: The module is not a counter module
-3: Counter not initialised see function "i_PCI3009_InitCounter"
-4: Interrupt routine not installed see function "i_PCI3009_SetBoardIntRoutine"
_INT_ i_PCI3009_DisableLatchInterrupt ( DWORD_  dw_BoardHandle)

Disable the latch interrupt

Parameters
[in]dw_BoardHandle: Handle of board PCI-3009
Returns
0: No error
-1: The handle parameter of the board is wrong
-2: The module is not a counter module
-3: Counter not initialised see function "i_PCI3009_InitCounter"
_INT_ i_PCI3009_Read16BitCounterValue ( DWORD_  dw_BoardHandle,
BYTE_  b_SelectedCounter,
PWORD_  pw_CounterValue 
)

Latch the selected 16-Bit counter (b_SelectedCounter) in to the first latch register and return the
latched value.

Parameters
[in]dw_BoardHandle: Handle of board PCI-3009
[in]b_SelectedCounter: Selected 16-Bit counter (0 or 1)
[out]pw_CounterValue: 16-Bit counter value
Returns
0: No error
-1: The handle parameter of the board is wrong
-2: The module is not a counter module
-3: Counter not initialised see function "i_PCI3009_InitCounter"
-4: The selected 16-Bit counter parameter is wrong
_INT_ i_PCI3009_Read32BitCounterValue ( DWORD_  dw_BoardHandle,
PDWORD_  pdw_CounterValue 
)

Latch the 32-Bit counter in to the first latch register and return the latched value.

Parameters
[in]dw_BoardHandle: Handle of board PCI-3009
[out]pdw_CounterValue: 32-Bit counter value
Returns
0: No error
-1: The handle parameter of the board is wrong
-2: The module is not a counter module
-3: Counter not initialised see function "i_PCI3009_InitCounter"