sapi_task.h

Go to the documentation of this file.

#ifndef SAFEAPI_OS_TASK_H
#define SAFEAPI_OS_TASK_H
 
#include "safeapi/utils/status/sapi_status.h"
#include "safeapi/utils/types/sapi_types.h"
 
#ifdef __cplusplus
extern "C" {
#endif

SAFEAPI_DECLARE_STORAGE(sapi_task_storage_t, 128U);

typedef struct sapi_task_impl_s *sapi_task_handle_t;

typedef void (*sapi_task_entry_t)(void *user_ctx);

typedef struct sapi_task_config_s
{
    const char        *name;         
    sapi_task_entry_t  entry;        
    void              *user_ctx;     
    sapi_duration_ms_t period_ms;    
    uint32_t           priority;     
    size_t             stack_size;   
} sapi_task_config_t;

sapi_status_t sapi_task_create(sapi_task_storage_t *storage,
                                const sapi_task_config_t *config,
                                sapi_task_handle_t *out_handle);

sapi_status_t sapi_task_start(sapi_task_handle_t handle);

sapi_status_t sapi_task_suspend(sapi_task_handle_t handle);

sapi_status_t sapi_task_destroy(sapi_task_handle_t handle);
 
/*
 * The backend vtable (sapi_task_backend_t) and sapi_task_register_backend()
 * live in safeapi_backend/task/sapi_task_backend.h, not here (ADR-021).
 * This header is the consumer-facing surface only.
 */
 
#ifdef __cplusplus
}
#endif
 
#endif /* SAFEAPI_OS_TASK_H */
 /* TASK */