int ar_get_latest_t (short board, short channel, unsigned short label, unsigned int * data, TIME_TAG_TYPE * timeTag);
This
function retrieves the latest ARINC 429 message and time-stamp received for the
specified channel/label combination from the snapshot buffer.
When using
this function, the host application should set the snapshot storage mode to label field only, (see the
documentation on the function ar_set_device_config, for the configuration
option ARU_ACCESS_SNAPSHOT_BUFFER). This
sets up the device to store the ARINC 429 message and time-stamp in the
snapshot buffer based on the label field value only, ignoring the SDI bit field
value.
If no message has been received for the specified channel/label since the last initialization of the device, a data value of zero is returned for the message and time-stamp. If the timeTag parameter is NULL, no time-stamp information is returned.
Input |
|
|
Name |
Type |
Description |
board |
short |
(input) Device Number of the board to reference, (valid range is 0-15). |
channel |
short |
(input) Specifies which receive channel this routine is to access. Valid range is 0 to one less than the installed ARINC 429 receive channel count. |
label |
unsigned short |
(input) The label value of interest. |
Output |
|
|
Name |
Type |
Description |
data |
unsigned int (passed by reference) |
(output) The latest received 32-bit ARINC 429 message value for the specified label. |
timeTag |
TIME_TAG_TYPE (passed by reference) |
(output) The 64-bit message time-stamp, the format of which is determined by the current selected API time-tag reference. |
Name |
Type |
Description |
status |
short |
status of the function
call, with valid values of: ARS_INVHARVAL The channel parameter was not valid for this device configuration. |
Receive Data Processing Functions
Alphabetical
Function Index
Hierarchical
Function Index