Renesas M3T-MR100 Network Card User Manual


 
- 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.