beautypg.com

Renesas Emulator System M3T-MR100 User Manual

Page 83

background image

- 67 -

can_act

Cancel task activation request

ican_act

Cancel task activation request (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_UINT actcnt = can_act( ID tskid );
ER_UINT actcnt = ican_act( ID tskid );

z

z

P

P

a

a

r

r

a

a

m

m

e

e

t

t

e

e

r

r

s

s

ID tskid

ID number of the task to cancel

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_UINT

actcnt > 0

Canceled activation request count

actcnt < 0

Error code

[

[

[

[

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
can_act TSKID
ican_act TSKID

z

z

P

P

a

a

r

r

a

a

m

m

e

e

t

t

e

e

r

r

s

s

TSKID

ID number of the task to cancel

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

R2R0

Canceled startup request count or error code

[

[

[

[

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 finds the number of task activation requests enqueued for the task indicated by tskid, returns the result as a
return parameter, and at the same time invalidates all of the task’s activation requests.

Specifying tskid=TSK_SELF(0) specifies the issuing task itself. If TSK_SELF is specified for tskid in non-task context,
operation of this service call cannot be guaranteed.

This service call can be invoked for a task in DORMANT state as the target task. In that case, the return parameter is 0.

If this service call is to be issued from task context, use can_act; if issued from non-task context, use ican_act.