01.06.2013 Views

IPC@CHIP Documentation - SC12 @CHIP-RTOS V1.10

IPC@CHIP Documentation - SC12 @CHIP-RTOS V1.10

IPC@CHIP Documentation - SC12 @CHIP-RTOS V1.10

SHOW MORE
SHOW LESS

You also want an ePaper? Increase the reach of your titles

YUMPU automatically turns print PDFs into web optimized ePapers that Google loves.

AH<br />

BX<br />

ES:DI<br />

DS:SI<br />

0x40 (= RTX_CREATE_EVENTGROUP)<br />

Initial value of the 16 event flags of the group.<br />

Output Parameter: Pointer to 16 bit storage where Event Group ID is output by this API.<br />

Pointer to unique four character tag, which need not be a zero terminated string but must consists of four<br />

bytes.<br />

Return Value<br />

Comments<br />

DX = 0 success AX: 0 , location at [ES:DI] contains the unique group ID.<br />

DX != 0 failure AX: contains error code, no free event group entry available<br />

Each event group provides 16 Boolean event flags, encoded in a 16 bit word. Users are free to assign<br />

any meaning to these Booleans that suites their application.<br />

Event groups can provide control and communicate between programs. One program creates the event<br />

group and the other programs must know the event group's unique 4 character tag. The other programs<br />

can then obtain the handle to this event group following its creation using the RTX_FIND_EVENTGROUP<br />

API.<br />

Related Topics<br />

Top of list<br />

Index page<br />

<strong>RTOS</strong> Event Manager<br />

Interrupt 0xAD service 0x41: RTX_DELETE_EVENTGROUP, Delete an event group<br />

Parameters<br />

AH<br />

BX<br />

Deletes specified event group.<br />

0x41 (= RTX_DELETE_EVENTGROUP)<br />

Event group ID acquired by RTX_CREATE_EVENTGROUP call.<br />

Return Value<br />

DX = 0 success AX: 0<br />

DX != 0 failure AX: contains error code, event group still in use or invalid group ID<br />

Page 209 / 400

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!