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

BX
ES:DI
0x19 (= RTX_RESERVE_RES)
ID of the semaphore acquired from RTX_CREATE_SEM
Pointer to signed long buffer containing the timeout in milliseconds
if timeout == 0, the caller waits forever for the resource
if timeout < 0, value is illegal resulting in error code -48
Return Value
Comments
DX =0 success AX: 0
DX!=0 failure AX: contains error code, semaphore is in use
This call waits for a defined time to reserve a semaphore and returns with an error code -27 if the
semaphore is still in use by another task after the timeout period expires.
The callers wait in FIFO order for the semaphore.
On success, the calling task then owns the resource semaphore. A task which owns the semaphore is
free to call here repeated times, reserving the same semaphore more than once. Each such call
increments a "use count" internal to the semaphore. This use count must be restored to zero before any
other task can be granted ownership of this resource semaphore.
Related Topics
Top of list
Index page
RTX_FREE_RES Free resource semaphore
RTX_RELEASE_SEM Release resource semaphore
RTOS Semaphore Services
Interrupt 0xAD service 0x1A: RTX_SIGNAL_SEM, Signal a counting semaphore
Parameters
AH
BX
Make semaphore access available to one additional task.
0x1A (= RTX_SIGNAL_SEM)
ID of the semaphore acquired from RTX_CREATE_SEM
Return Value
DX =0 success AX: 0
DX!=0 failure AX: contains error code
Page 195 / 400