short ar_getnext_xt (short board, short channel, unsigned int * destination, AR_TIMETAG_TYPE * timeTagRef);
This function retrieves the most stale unread message and time-tag from the specified receive channel. If no data is present in the receiver FIFO buffer, this function attempts to retrieve data for up to one-half second. If no data is present after one-half second, a time-out status 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. |
Output |
|
|
Name |
Type |
Description |
destination |
unsigned int (passed by reference) |
(output) The received ARINC 429 message. |
timeTagRef |
AR_TIMETAG_TYPE (passed by reference) |
(output) The time-tag data structure associated with the
data. Defined as follows: |
Name |
Type |
Description |
status |
short |
status
of the function call, with valid values of: ARS_INVARG The destination parameter reference was NULL. ARS_BOARD_MUTEX Access to the Board Lock timed-out/failed. ARS_BAD_MESSAGE An invalid length ARINC 429 message was detected. |
Receive Data Processing Functions
Alphabetical
Function Index
Hierarchical
Function Index