Program Interface Library AR_GETWORDT
CEI-100/CEI-200/CEI-x20 User’s Manual 102
AR_GETWORDT
CEI_INT16 ar_getwordt (CEI_INT16 board, CEI_INT16 channel,
CEI_INT32 *destination, CEI_INT32 *timetag);
This routine gets the next available 32-bit ARINC word from the requested
channel's buffer and puts it in the desired destination along with its
timetag. It is used only if time tags have been selected by a previous call
to AR_TIMETAG_CONTROL.
If it successfully returns data, there may or may not be more data in the
buffer. It only means there was at least one ARINC word plus timetag in
the buffer. This routine removes it from the buffer and returns it to you.
Subsequent calls would be required to determine if more words are in the
buffer. If it returns ARS_NODATA, the buffer is empty. This is a
circular FIFO buffer that is constantly maintained by the interface board.
See AR_GETWORD for a description of the data formats returned by this
function.
ARS_NODATA No word available.
ARS_GOTDATA Read one ARINC word with timetag.
ARS_INVBOARD Invalid board number.
ARS_BRDNOTLOAD Board not initialized.
ARS_INVARG Invalid channel number.
ARS_NO_HW_SUPRT Non-implemented channel.
ARS_BOARD_MUTEX Failed to acquire/release the board lock.
ARS_THREAD_WAITING An 'await data' mode thread is already
waiting to receive a word.
ARS_WAIT_FAILED Receiver 'await data' mode is enabled and
the wait operation failed.
Artisan Technology Group - Quality Instrumentation ... Guaranteed | (888) 88-SOURCE | www.artisantg.com