ar_putblock

short ar_putblock (unsigned int board, unsigned int channel, int maxMessages, int offset, int * data, int *actualCount);

Purpose

This function transfers the array of messages to the specified channel transmit buffer.   When this routine returns, the data has not necessarily been sent, it has only been placed in the transmit buffer.  If other data is in the transmit buffer ahead of it, this data will be transmitted in turn.

Parameters

Input

Name

Type

Description

board

unsigned int

(input) Device Number of the board to reference, (valid range is 0-15).

channel

unsigned int

(input) Device channel number on which to transmit (valid range is 0 to one less than the installed ARINC 429 transmit channel count).

maxMessages

int

(input) The number of messages to transmit.

offset

int

Unused parameter, retained for legacy API support only.

data

int (passed by reference)

(input) Array supplying the 32-bit ARINC 429 message values.

Output

 

 

Name

Type

Description

actualCount

int (passed by reference)

(output) The number of ARINC 429 messages actually inserted in the transmit buffer.

Return Value

Name

Type

Description

status

short

status of the function call, with valid values of:
ARS_NORMAL            Success.
ARS_INVBOARD        Invalid or uninitialized board.
ARS_INVHARVAL       Invalid transmit channel entry.
ARS_INVARG            Invalid maxMessages parameter value or NULL data or actualCount parameters.

ARS_BOARD_MUTEX Access to the Board Lock timed-out/failed.
ARS_XMITOVRFLO    A transmit buffer overrun was encountered.

References

Transmit Data Processing Functions
Alphabetical Function Index
Hierarchical Function Index

CEI-x30 API Description