- 125 -
ref_dtq
Reference data queue status
iref_dtq
Reference data queue status (handler only)
[
[
[
[
C
C
L
L
a
a
n
n
g
g
u
u
a
a
g
g
e
e
A
A
P
P
I
I
]
]
]
]
ER ercd = ref_dtq( ID dtqid, T_RDTQ *pk_rdtq );
ER ercd = iref_dtq( ID dtqid, T_RDTQ *pk_rdtq );
z
z
P
P
a
a
r
r
a
a
m
m
e
e
t
t
e
e
r
r
s
s
ID
dtqid
ID number of the target data queue
T_RDTQ
*pk_rdtq
Pointer to the packet to which data queue status is returned
z
z
R
R
e
e
t
t
u
u
r
r
n
n
P
P
a
a
r
r
a
a
m
m
e
e
t
t
e
e
r
r
s
s
ER ercd Terminated
normally (E_OK)
T_RDTQ
*pk_rdtq
Pointer to the packet to which data queue status is returned
Contents of pk_rdtq
typedef struct
t_rdtq{
ID
stskid
+0
2
Transmission waiting task ID
ID
wtskid
+2
2
Reception waiting task ID
UINT
sdtqcnt
+4
4
Data bytes contained in data queue
} T_RDTQ;
[
[
[
[
A
A
s
s
s
s
e
e
m
m
b
b
l
l
y
y
l
l
a
a
n
n
g
g
u
u
a
a
g
g
e
e
A
A
P
P
I
I
]
]
]
]
.include mr100.inc
ref_dtq DTQID,
PK_RDTQ
iref_dtq DTQID, PK_RDTQ
z
z
P
P
a
a
r
r
a
a
m
m
e
e
t
t
e
e
r
r
s
s
DTQID
ID number of the target data queue
PK_RDTQ
Pointer to the packet to which data queue status is returned
z
z
R
R
e
e
g
g
i
i
s
s
t
t
e
e
r
r
c
c
o
o
n
n
t
t
e
e
n
n
t
t
s
s
a
a
f
f
t
t
e
e
r
r
s
s
e
e
r
r
v
v
i
i
c
c
e
e
c
c
a
a
l
l
l
l
i
i
s
s
i
i
s
s
s
s
u
u
e
e
d
d
Register name
Content after service call is issued
R0 Error
code
R2
ID number of the target data queue
A1
Pointer to the packet to which data queue status is returned
[
[
[
[
E
E
r
r
r
r
o
o
r
r
c
c
o
o
d
d
e
e
]
]
]
]
None
[
[
[
[
F
F
u
u
n
n
c
c
t
t
i
i
o
o
n
n
a
a
l
l
d
d
e
e
s
s
c
c
r
r
i
i
p
p
t
t
i
i
o
o
n
n
]
]
]
]
This service call returns various statuses of the data queue indicated by dtqid.
stskid
Returned to stskid is the ID number of the task at the top of a transmission waiting queue (the next task to be de-
queued). If no tasks are kept waiting, TSK_NONE is returned.
wtskid
Returned to wtskid is the ID number of the task at the top of a reception waiting queue (the next task to be de-
queued). If no tasks are kept waiting, TSK_NONE is returned.
sdtqcnt
Returned to sdtqcnt is the number of data bytes stored in the data queue area.
If this service call is to be issued from task context, use ref_dtq; if issued from non-task context, use iref_dtq.
