beautypg.com

Renesas Emulator System M3T-MR100 User Manual

Page 213

background image

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