LDK_JOBS_DEFAULT_WORKER_COUNT

#define LDK_JOBS_DEFAULT_WORKER_COUNT 4u

LDKJobs

typedef struct LDKJobs{
  void *internal;
  bool is_initialized;
}LDKJobs;

LDKAsyncResultState

typedef struct LDKAsyncResultState LDKAsyncResultState;

LDKAsyncResult

typedef struct LDKAsyncResult{
  LDKAsyncResultState *state;
}LDKAsyncResult;

LDKJobFunc

Callback executed as a job by the work scheduler.

typedef bool(*LDKJobFunc)(void *user_data);

LDKAsyncStatus

typedef enum LDKAsyncStatus{
  LDK_ASYNC_STATUS_INVALID=0,
  LDK_ASYNC_STATUS_PENDING,
  LDK_ASYNC_STATUS_RUNNING,
  LDK_ASYNC_STATUS_SUCCEEDED,
  LDK_ASYNC_STATUS_FAILED,
}LDKAsyncStatus;

ldk_jobs_initialize

Initialize the jobs.

LDK_API bool ldk_jobs_initialize(
 LDKJobs *jobs,
 u32 worker_count
);

ldk_jobs_terminate

Shut down the jobs.

LDK_API void ldk_jobs_terminate(LDKJobs *jobs);

ldk_jobs_terminate_with_diagnostics

Shut down the job system and collect termination diagnostics.

LDK_API void ldk_jobs_terminate_with_diagnostics(
 LDKJobs *jobs,
 XThreadPoolShutdownCallback callback,
 void *user_data
);

ldk_jobs_submit

Submit work to the job pool and obtain an asynchronous result.

LDK_API LDKAsyncResult ldk_jobs_submit(
 LDKJobs *jobs,
 LDKJobFunc function,
 void *user_data
);

ldk_async_result_is_valid

Check whether the async result is valid.

LDK_API bool ldk_async_result_is_valid(LDKAsyncResult result);

ldk_async_result_is_done

Check whether an asynchronous job has completed.

LDK_API bool ldk_async_result_is_done(LDKAsyncResult result);

ldk_async_result_status

Read the completion status of an asynchronous job.

LDK_API LDKAsyncStatus ldk_async_result_status(LDKAsyncResult result);

ldk_async_result_wait

Wait for an asynchronous job to complete.

LDK_API bool ldk_async_result_wait(LDKAsyncResult result);

ldk_async_result_release

Release resources associated with an asynchronous result.

LDK_API void ldk_async_result_release(LDKAsyncResult *result);