ar_get_snap_data

int ar_get_snap_data (short board, short channel, unsigned short label, unsigned short sdi, unsigned int * data);

Purpose

This function retrieves the latest ARINC 492 message received for the specified channel/label/SDI combination from the snapshot buffer.  

When using this function, the host application should set the snapshot storage mode to label/SDI storage, (see the documentation on the function ar_set_device_config, for the configuration option ARU_ACCESS_SNAPSHOT_BUFFER).  This will setup the device to store snapshot data based on the label field value in combination with the SDI bit field value.

Parameters

Input

Name

Type

Description

board

short

(input) Device Number for the referenced board, (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 field value of interest.

sdi

unsigned short

(input) The SDI field 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/SDI field values.

Return Value

Name

Type

Description

status

short

status of the function call, with valid values of:
ARS_NORMAL            Routine execution was successful.
ARS_BOARD_MUTEX  Access to the Board Lock timed-out/failed.
ARS_INVBOARD        The board parameter value was invalid.
ARS_INVARG            An invalid label or sdi parameter value or null data parameter was provided.

ARS_INVHARVAL       The channel parameter was not valid for this device configuration.

References

Receive Data Processing Functions
Alphabetical Function Index
Hierarchical Function Index

CEI-x30 API Description