Renesas Emulator System M3T-MR100, User Manual

Page: 213 / 306

- 197 -
vrst_dtq Clear data queue area
[
[
[
[
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 = vrst_dtq( ID dtqid );
z
z P
P
a
a
r
r
a
a
m
m
e
e
t
t
e
e
r
r
s
s
ID dtqid Data queue ID to be cleared
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)
[
[
[
[
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
vrst_dtq DTQID
z
z
P P a a r r a a m m e e t t e e r r s s
DTQID Data queue ID to be cleared
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 Data queue ID to be cleared
[
[
[
[
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 clears the data stored in the data queue indicated by dtqid. If the data queue area has no more areas to be
added and tasks are enqueued in a data transmission waiting queue, all of the tasks enqueued in the data transmission wait-
ing queue are released from WAITING state. Furthermore, the error code EV_RST is returned to the tasks that have been
released from WAITING state.
Even when the number of data queues defined is 0, all of the tasks enqueued in a data transmission waiting queue are re-
leased from WAITING state.
This service call can be issued only from task context. It cannot be issued from non-task context.