-
prcv_dtq
iprcv_dtq
-
Receive from data queue (polling).
ER prcv_dtq (ID dtqid, VP_INT *p_data);
ER iprcv_dtq (ID dtqid, VP_INT *p_data);
|
|
|
|
ID dtqid;
|
ID number of the data queue.
|
|
VP_INT *p_data;
|
Data element received from the data queue.
|
These service calls process as follows according to the situation of the data queue specified by the parameter
dtqid.
- There is a data in the data queue.
This service call takes out the oldest data from the data queue and stores the data to the area specified by
p_data.
When there is a task in the transmission wait queue, this service call stores the data sent by the task in the top of the transmission wait queue and moves it from the WAITING state (data transmission wait state) to the READY state.
- There is no data in the data queue and there is a task in the transmission wait queue.
These service calls store the data specified by the task in the top of the transmission wait queue to the area specified by
p_data. As a result, the task is unlinked from the transmission wait queue and moves from the WAITING state (data transmission wait state) to the READY state, or from the WAITING-SUSPENDED state to the SUSPENDED state.
Note, this situation is caused only when the capacity of the data queue is 0.
- There is no data in the data queue and there is no task in the transmission wait queue.
These service calls return "E_TMOUT".
|
|
|
|
|
|
|
|
|
|
|
- This service call was issued in the CPU locked state.
- The iprcv_dtq was issued from task.
- The prcv_dtq was issued from non-task.
- This service call was issued in the status "PSW.IPL > kernel interrupt mask level".
|
|
|
|