AlazarGetTriggerAddress#

Function Syntax#

RETURN_CODE AlazarGetTriggerAddress(HANDLE handle, U32 Record, U32 *TriggerAddress, U32 *TimeStampHighPart, U32 *TimeStampLowPart)#

Get the timestamp and trigger address of the trigger event in a record acquired to on-board memory.

The following code fragment demonstrates how to convert the trigger timestamp returned by AlazarGetTriggerAddress() from counts to seconds.

__int64 timeStamp_cnt;
timeStamp_cnt = ((__int64) timestampHighPart) << 8;
timeStamp_cnt |= timestampLowPart & 0x0ff;
double samplesPerTimestampCount = 2; // board specific constant
double samplesPerSec = 50.e6; // sample rate
double timeStamp_sec = (double) samplesPerTimestampCount *
timeStamp_cnt / samplesPerSec;

The sample per timestamp count value depends on the board model. See board-specific information to know which value applies to which board.

Remark

This function can be used in single-port acquisitions only.

Parameters

  • handle – [in] Board handle

  • Record – [in] Record in acquisition (1-indexed)

  • TriggerAddress – [out] The trigger address

  • TimeStampHighPart – [out] The most significant 32-bits of a record timestamp

  • TimeStampLowPart – [out] The least significant 8-bits of a record timestamp

Returns

ApiError2 (604) if it is called after a dual-port acquisition. This function should be called after a single-port acquisition only.

Returns

ApiSuccess upon success, or an error code. See RETURN_CODE for more detailed information.

LabVIEW Block Diagram#

../_images/AlazarGetTriggerAddress.vi.png