[ Pobierz całość w formacie PDF ]

T_PTR _mutatr_init.
Returns :
" MQX_EOK
" MQX_EINVAL (Attr_ptr is NULL or points to an invalid attributes structure.)
See also :
" _mutatr_init
" MUTEX_ATTR_STRUCT
Description :
Freescale MQX"! Lite RTOS, Rev. Version 1.1
64 Freescale Semiconductor, Inc.
Chapter 2 MQX Lite Functions
To reuse the mutex attributes structure, a task must reinitialize the structure.
2.9.2 _mutatr_get_priority_ceiling
Gets the priority ceiling from a mutex attributes structure.
Source :
Prototype :_mqx_uint _mutatr_get_priority_ceiling(MUTEX_ATTR_STRUCT_PTR attr_ptr,
_mqx_uint_ptr ceiling_ptr);
Table 2-55. _mutatr_get_priority_ceiling arguments
Name Type Direction Description
MUTEX_ATTR_STRUC attr_ptr input Pointer to an initialized mutex attributes structure.
T_PTR
_mqx_uint_ptr ceiling_ptr output Pointer to the current priority.
Returns :
" MQX_EOK
" MQX_EINVAL (Attr_ptr is NULL or points to an invalid attributes structure.)
See also :
" _mutatr_set_priority_ceiling
" _mutatr_init
" MUTEX_ATTR_STRUCT
Description :
Priority applies only to mutexes whose scheduling protocol is priority protect.
2.9.3 _mutatr_get_sched_protocol
Gets the scheduling protocol of the mutex attributes structure.
Source :
Prototype :_mqx_uint _mutatr_get_sched_protocol(MUTEX_ATTR_STRUCT_PTR attr_ptr,
_mqx_uint_ptr protocol_ptr);
Freescale MQX"! Lite RTOS, Rev. Version 1.1
Freescale Semiconductor, Inc. 65
Mutexes
Table 2-56. _mutatr_get_sched_protocol arguments
Name Type Direction Description
MUTEX_ATTR_STRUC attr_ptr input Pointer to an initialized mutex attributes structure.
T_PTR
_mqx_uint_ptr protocol_ptr output Pointer to the current scheduling protocol.
Returns :
" MQX_EOK
" MQX_EINVAL (Attr_ptr is NULL or points to an invalid attributes structure.)
See also :
" _mutatr_set_sched_protocol
" _mutatr_init
" _mutatr_get_priority_ceiling
" _mutatr_set_priority_ceiling
" MUTEX_ATTR_STRUCT
2.9.4 _mutatr_get_spin_limit
Gets the spin limit of the mutex attributes structure.
Source :
Prototype :_mqx_uint _mutatr_get_spin_limit(MUTEX_ATTR_STRUCT_PTR attr_ptr, _mqx_uint_ptr
spin_count_ptr);
Table 2-57. _mutatr_get_spin_limit arguments
Name Type Direction Description
MUTEX_ATTR_STRUC attr_ptr input Pointer to an initialized mutex attributes structure.
T_PTR
_mqx_uint_ptr spin_count_ptr output Pointer to the current spin limit.
Returns :
" MQX_OK
" MQX_EINVAL (Attr_ptr is NULL or points to an invalid attributes structure.)
See also :
" _mutatr_set_spin_limit
" _mutatr_init
" _mutatr_get_wait_protocol
Freescale MQX"! Lite RTOS, Rev. Version 1.1
66 Freescale Semiconductor, Inc.
Chapter 2 MQX Lite Functions
" _mutatr_set_wait_protocol
" MUTEX_ATTR_STRUCT
Description :
Spin limit applies only to mutexes whose waiting policy is limited spin. Spin limit is the
number of times that a task spins (is rescheduled) while it waits for the mutex.
2.9.5 _mutatr_get_wait_protocol
Gets the waiting policy of the mutex attributes structure.
Source :
Prototype :_mqx_uint _mutatr_get_wait_protocol(MUTEX_ATTR_STRUCT_PTR attr_ptr,
_mqx_uint_ptr waiting_protocol_ptr);
Table 2-58. _mutatr_get_wait_protocol arguments
Name Type Direction Description
MUTEX_ATTR_STRUC attr_ptr input Pointer to an initialized mutex attributes structure.
T_PTR
_mqx_uint_ptr waiting_protocol_ptr output Pointer to the current waiting protocol.
Returns :
" MQX_EOK
" MQX_EINVAL (Attr_ptr is NULL or points to an invalid attribute structure.)
See also :
" _mutatr_set_wait_protocol
" _mutatr_init
" _mutatr_get_spin_limit
" _mutatr_set_spin_limit
" MUTEX_ATTR_STRUCT
2.9.6 _mutatr_init
Initializes the mutex attributes structure to default values.
Source :
Prototype :_bmqx_uint _mutatr_init(register MUTEX_ATTR_STRUCT_PTR attr_ptr);
Freescale MQX"! Lite RTOS, Rev. Version 1.1
Freescale Semiconductor, Inc. 67
Mutexes
Table 2-59. _mutatr_init arguments
Name Type Direction Description
register attr_ptr input Pointer to the mutex attributes structure to initialize.
MUTEX_ATTR_STRUC
T_PTR
Returns :
" MQX_EOK
" MQX_EINVAL (Attr_ptr is NULL or points to an invalid attributes structure or
attributes structure is already initialized.)
See also :
" _mutex_init
" _mutatr_destroy
" MUTEX_ATTR_STRUCT
Description :
The function initializes the mutex attributes structure to default values and validates the
structure. It must be called before a task can modify the values of the mutex attributes
structure. The function does not affect any mutexes already initialized with this structure.
Mutex attribute Field in MUTEX_ATTR_STRUCT Default value
Scheduling protocol POLICY MUTEX_NO_PRIO_INHERIT
Valid VALID TRUE
Priority PRIORITY 0
Spin limit COUNT 0
Waiting protocol WAITING POLICY MUTEX_QUEUEING
2.9.7 _mutatr_set_priority_ceiling
Sets the priority ceiling of a mutex attributes structure.
Source :
Prototype :_mqx_uint _mutatr_set_priority_ceiling(MUTEX_ATTR_STRUCT_PTR attr_ptr, _mqx_uint
ceiling);
Freescale MQX"! Lite RTOS, Rev. Version 1.1
68 Freescale Semiconductor, Inc.
Chapter 2 MQX Lite Functions
Table 2-60. _mutatr_set_priority_ceiling arguments
Name Type Direction Description
MUTEX_ATTR_STRUC attr_ptr input Pointer to an initialized mutex attributes structure.
T_PTR
_mqx_uint ceiling input New priority ceiling to use.
Returns :
" MQX_EOK
" MQX_EINVAL
See also :
" _mutatr_get_priority_ceiling
" _mutatr_init
" MUTEX_ATTR_STRUCT
Description : [ Pobierz całość w formacie PDF ]