![abaco systems CEI-100 Series User Manual Download Page 82](http://html.mh-extra.com/html/abaco-systems/cei-100-series/cei-100-series_user-manual_450728082.webp)
Program Interface Library
AR _CANCEL_DATA_WAIT
CEI-100/CEI-200/CEI-
x20 User’s Manual
70
AR _CANCEL_DATA_WAIT
CEI_INT16 ar_cancel_data_wait (CEI_INT16 board, CEI_INT16
channel)
If 'await data' mode is enabled for the given receive channel and a thread is
currently asleep (in AR_GETWORD or AR_GETWORDT) waiting to
receive a word on the channel in question, then calling this function
cancels the pending wait operation and awakens the waiting thread.
If no data word is available in the channel's sequential receive buffer when
a sleeping thread is awakened, the call to AR_GETWORD or
AR_GETWORDT returns ARS_NODATA.
A call to AR_CANCEL_DATA_WAIT may return before the waiting
thread (if any) has fully processed the cancellation request.
Use AR_SET_CONFIG to disable 'await data' mode on a particular
receiver. Note that AR_CANCEL_DATA_WAIT does not disable 'await
data' mode on the channel in question.
ARS_NORMAL
Operation completed successfully.
ARS_INVBOARD
Invalid board number.
ARS_INVARG
Invalid channel index.
ARS_BRDNOTLOAD
Board not initialized.
ARS_BOARD_MUTEX
Failed to acquire/release the board lock.
ARS_SIGNAL_FAILED
Failed to signal waiting thread.
board
(input) board number.
channel
(input) receive channel.
Syntax
Description
Return Value
Arguments
Artisan Technology Group - Quality Instrumentation ... Guaranteed | (888) 88-SOURCE | www.artisantg.com