OSTaskRegGetID
Description
OSTaskRegGetID()
allows your application to assign task register IDs dynamically. In other words, instead of using #define
constants to establish a task register number (or index) into the .TaskReg[]
shown below, you should always use OSTaskRegGetID()
, assign the ID to a variable and use this ID when calling OSTaskRegGet()
or OSTaskRegSet()
.
If successful, OSTaskRegGetID()
will return an ID between 0
and OS_CFG_TASK_REG_TBL_SIZE-1.
Files
os.h/os_task.c
Prototype
OS_REG_ID OSTaskRegGetID (OS_ERR *p_err)
Arguments
p_err
is a pointer to a variable that will contain an error code returned by this function.
OS_ERR_NONE
If the call was successful and the function returned the next available task register ID (or index).
OS_ERR_NO_MORE_ID_AVAIL
If you already called OSTaskRegGetID()
OS_CFG_TASK_REG_TBL_SIZE
(see os_cfg.h
) times and thus there are no more IDs available to be assigned.
Returned Value
The next available task register ID or OS_CFG_TASK_REG_TBL_SIZE
if all the IDs have already been assigned.
Required Configuration
OS_CFG_TASK_REG_TBL_SIZE
must be greater than 0 in os_cfg.h
. Refer to µC-OS-III Configuration Manual.
Callers
Application.
Notes/Warnings
None
Example Usage
OS_REG_ID MyTaskRegID; void main (void) { OS_ERR err; : OSInit(&err); : MyTaskRegID = OSTaskRegGetID(&err); /* Check "err" */ : : OSStart(&err); }