STW TC1 - Page 262

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