STW TC1, User Manual

Page: 262 / 374

7 Teleservice Application Framework
User Manual 262/374
Information Flow
Input Information
Parameter Range Description
osn_SHMKey Specifies either the IPC_PRIVATE value or an
IPC key constructed by the ftok subroutine
Output Information
Parameter Range Description
ops32_SemID includes the semaphore ID
Return Value Description
C_NO_ERR Function executed without error, a semaphore ID was successful generated
C_CONFIG invalid semaphore key
7.3.12.19 utils_semaphore_lock
Function Description
sint32 utils_semaphore_lock (const sint32 os32_SemID
,
const uint8 ou8_Mode
)
The function locks the created semaphore with the ID os32_SemID. Use this function before entering a critical
section.
Information Flow
Input Information
Parameter Range Description
os32_SemID includes the semaphore ID
ou8_Mode 0 ... 1 0: Wait until it is possible to access the critical
section
1: No waiting. If it is not possible to enter the
section, return with an error
Output Information
Return Value Description
C_NO_ERR Function executed without error
C_CONFIG The semaphore ID is smaller than zero