...
Files
os.h/os_tls.c
Prototype
Code Block |
---|
OS_TLS OS_TLS_GetValue (OS_TCB *p_tcb,
OS_TLS_ID id,
OS_ERR *p_err); |
Arguments
p_tcb
is a pointer to the OS_TCB
of the task you wish to retrieve the TLS from. You will get a copy of the p_tcb->TLS_Tbl[id]
entry and of course, the entry will not be changed.
...
The value store in p_tcb->TLS_Tbl[id]
or NULL
if an error occurred.
Required Configuration
OS_CFG_TLS_TBL_
SIZE must SIZE
must be higher greater than 0 in os_cfg.h
. Refer to uCµC-OS-III Configuration Manual.
Callers
Application.
Notes/Warnings
- You cannot call
OS_TLS_GetValue()
for a task until that task gets created.
Example Usage
Code Block | ||
---|---|---|
| ||
OS_TLS_ID MyTLS_ID;
void MyTask (void *p_arg)
{
OS_ERR err;
OS_TLS p_tls;
:
:
while (DEF_TRUE) {
p_tls = OS_TLS_GetValue((OS_TCB *)0,
(OS_TLS_ID)MyTLS_ID,
(OS_ERR *)&err);
/* Check "err" */
:
:
}
} |