Generated from cl_thread.h with ROBODoc v3.2.3 on Sat Jan 18 07:05:18 2003
TABLE OF CONTENTS
- Component Library: Thread/cl_pfn_thread_callback_t
- Component Library: Thread/cl_proc_count
- Component Library: Thread/cl_thread_stall
- Component Library: Thread/cl_thread_suspend
NAME
cl_pfn_thread_callback_t
DESCRIPTION
The cl_pfn_thread_callback_t function type defines the prototype
for functions invoked by thread objects
SYNOPSIS
typedef void
(*cl_pfn_thread_callback_t)(
IN void* context );
PARAMETERS
context
[in] Value specified in a call to cl_thread_init or
cl_thread_pool_create.
RETURN VALUE
This function does not return a value.
NOTES
This function type is provided as function prototype reference for
the function provided by users as a parameter to the cl_thread_init
and cl_thread_pool_create functions.
SEE ALSO
Thread Pool
NAME
cl_proc_count
DESCRIPTION
The cl_proc_count function returns the number of processors in the system.
SYNOPSIS
uint32_t
cl_proc_count( void );
RETURN VALUE
Returns the number of processors in the system.
NAME
cl_thread_stall
DESCRIPTION
The cl_thread_stall function stalls the calling thread for a minimum of
the specified number of microseconds.
SYNOPSIS
void
cl_thread_stall(
IN const uint32_t pause_us );
PARAMETERS
pause_us
[in] Number of microseconds to stall the calling thread.
RETURN VALUE
This function does not return a value.
NOTES
The cl_thread_stall function performs a busy wait for the specified
number of microseconds. Care should be taken when using this function as
it does not relinquish its quantum of operation. For longer wait
operations, users should call cl_thread_suspend if possible.
SEE ALSO
Thread, cl_thread_suspend
NAME
cl_thread_suspend
DESCRIPTION
The cl_thread_suspend function suspends the calling thread for a minimum
of the specified number of milliseconds.
SYNOPSIS
void
cl_thread_suspend(
IN const uint32_t pause_ms );
PARAMETERS
pause_ms
[in] Number of milliseconds to suspend the calling thread.
RETURN VALUE
This function does not return a value.
NOTES
This function should only be called if it is valid for the caller's thread
to enter a wait state. For stalling a thread that cannot enter a wait
state, callers should use cl_thread_stall.
SEE ALSO
Thread, cl_thread_stall