2022-02-02 17:19:49 +00:00
|
|
|
PR_QueueJob
|
|
|
|
===========
|
|
|
|
|
2022-02-02 17:07:53 +00:00
|
|
|
Queues a job to a thread pool for execution.
|
|
|
|
|
|
|
|
|
|
|
|
Syntax
|
|
|
|
------
|
|
|
|
|
2023-01-04 14:39:06 +00:00
|
|
|
.. code::
|
2022-02-02 17:07:53 +00:00
|
|
|
|
|
|
|
#include <prtpool.h>
|
|
|
|
|
|
|
|
NSPR_API(PRJob *)
|
|
|
|
PR_QueueJob(
|
|
|
|
PRThreadPool *tpool,
|
|
|
|
PRJobFn fn,
|
|
|
|
void *arg,
|
|
|
|
PRBool joinable
|
|
|
|
);
|
|
|
|
|
|
|
|
|
|
|
|
Parameters
|
|
|
|
~~~~~~~~~~
|
|
|
|
|
|
|
|
The function has the following parameters:
|
|
|
|
|
|
|
|
``tpool``
|
2022-02-02 17:19:49 +00:00
|
|
|
A pointer to a :ref:`PRThreadPool` structure previously created by a
|
|
|
|
call to :ref:`PR_CreateThreadPool`.
|
2022-02-02 17:07:53 +00:00
|
|
|
``fn``
|
|
|
|
The function to be executed when the job is executed.
|
|
|
|
``arg``
|
|
|
|
A pointer to an argument passed to ``fn``.
|
|
|
|
``joinable``
|
|
|
|
If ``PR_TRUE``, the job is joinable. If ``PR_FALSE``, the job is not
|
2022-02-02 17:19:49 +00:00
|
|
|
joinable. See :ref:`PR_JoinJob`.
|
2022-02-02 17:07:53 +00:00
|
|
|
|
|
|
|
|
|
|
|
Returns
|
|
|
|
~~~~~~~
|
|
|
|
|
2022-02-02 17:19:49 +00:00
|
|
|
Pointer to a :ref:`PRJob` structure or ``NULL`` on error.
|