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.
Artisan Technology Group - Quality Instrumentation ... Guaranteed | (888) 88-SOURCE | www.artisantg.com
To Next Page
Loading...