Everything

ref_dtq

Outline
Reference data queue state.
C format
Assembly format
 MOVW    BC, #LOWW(_pk_rdtq)
 MOV     A, #dtqid
 CALL    !!_ref_dtq

Parameter(s)
I/O
Parameter
Description
I
 ID      dtqid;
ID number of the data queue to be referenced.
O
 T_RDTQ  *pk_rdtq;
Pointer to the packet returning the data queue state.

[Data queue state packet: T_RDTQ]
 typedef struct  t_rdtq {
     ID      stskid;         /*Existence of tasks waiting for data transmission*/
     ID      rtskid;         /*Existence of tasks waiting for data reception*/
     UINT    sdtqcnt;        /*Number of data elements in data queue*/
 } T_RDTQ;

Explanation
These service calls store the detailed information of the data queue (existence of waiting tasks, number of data elements in the data queue, etc.) specified by parameter dtqid into the area specified by parameter pk_rdtq.
Note For details about the data queue state packet, refer to "12.5.4 Data queue state packet".
Return value
Macro
Value
Description
E_OK
0
Normal completion.