T-Kernel Specification (1.B0.02)

262 CHAPTER 6. T-KERNEL/DS FUNCTIONS
td sem que, td flg que, td mbx que, td mtx que
td smbf que, td rmbf que, td cal que, td acp que
td mpf que, td mpl que
Reference Queue
[C Language Interface]
INT ct = td_sem_que ( ID semid, ID list[], INT nent ) ; /* semaphore */
INT ct = td_flg_que ( ID flgid, ID list[], INT nent ) ; /* event flag */
INT ct = td_mbx_que ( ID mbxid, ID list[], INT nent ) ; /* mailbox */
INT ct = td_mtx_que ( ID mtxid, ID list[], INT nent ) ; /* mutex */
INT ct = td_smbf_que ( ID mbfid, ID list[], INT nent ) ; /* message buffer send */
INT ct = td_rmbf_que ( ID mbfid, ID list[], INT nent ) ; /* message buffer receive */
INT ct = td_cal_que ( ID porid, ID list[], INT nent ) ; /* rendezvous call */
INT ct = td_acp_que ( ID porid, ID list[], INT nent ) ; /* rendezvous accept */
INT ct = td_mpf_que ( ID mpfid, ID list[], INT nent ) ; /* fixed-size memory pool */
INT ct = td_mpl_que ( ID mplid, ID list[], INT nent ) ; /* variable-size memory pool */
[Parameters]
ID —id Object ID
ID list[] Location of waiting task IDs
INT nent Maximum number of list entries
[Return Parameters]
INT ct Number of waiting tasks
or Error Code
[Error Codes]
E ID
E NOEXS
Bad identifier
Object does not exist
[Description]
Gets a list of IDs of tasks waiting for the object designated in —id.
This function stores in the location designated in list up to nent task IDs, arranged in the order in which
tasks are queued, starting from the first task in the queue. The number of queued tasks is passed in the
return code. If return code > nent, this means not all task IDs could be stored.
Copyright c○ 2002, 2003 by T-Engine Forum
T-Kernel 1.B0.02