ar_getwordt

short ar_getwordt (short board, short channel, void * destination, void * timeTag);

Purpose

This function retrieves the most stale unread ARINC 429 message and time-tag from the specified receive channel.  

Parameters

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

any type (passed by reference)

(output) The received ARINC 429 message.

timeTag

any type (passed by reference)

(output) The time-tag associated with the received ARINC 429 message, (resolution is based on the current programmed timer reference).

Return Value

Name

Type

Description

status

short

status of the function call, with valid values of:
ARS_GOTDATA          Success - data returned.
ARS_NODATA            No data was available.
ARS_INVBOARD        The board parameter value was invalid.
ARS_INVHARVAL       The channel parameter was not valid for this device configuration.

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.

References

Receive Data Processing Functions
Alphabetical Function Index
Hierarchical Function Index

CEI-x30 API Description