ThreadDriver.h

/****************************************************************************
 * Platform Abstraction Layer
 * Daryl Borth 2026
 * ThreadDriver.h
 *
 * Platform threading backend Thread and Mutex delegate to. Exactly one
 * driver implements this and assigns the single global instance. Core and
 * application code should not implement against ThreadDriver directly -
 * use the Thread/Mutex wrappers in libgui/Thread.h instead.
 ***************************************************************************/
#pragma once
 
#include <stdint.h>

typedef void* (*ThreadEntry)(void* arg);
 
#include "Thread.h"
#include "Mutex.h"

class ThreadDriver
{
    public:
        virtual ~ThreadDriver() = default;

        virtual void init() = 0;
        virtual void shutdown() = 0;

        virtual bool createThread(ThreadEntry entry, void * arg, uint32_t stackSize, ThreadPriority priority, void ** outHandle) = 0;
        virtual void joinThread(void * thread) = 0;
        virtual void cancelThread(void * thread) = 0;
        virtual void suspendThread(void * thread) = 0;
        virtual void resumeThread(void * thread) = 0;
        virtual bool isThreadSuspended(void * thread) = 0;

        virtual void * createMutex() = 0;
        virtual void destroyMutex(void * mutex) = 0;
        virtual void lockMutex(void * mutex) = 0;
        virtual void unlockMutex(void * mutex) = 0;

        virtual void * createCond() = 0;
        virtual void destroyCond(void * cond) = 0;
        virtual void waitCond(void * cond, void * mutex) = 0;
        virtual void signalCond(void * cond) = 0;

        virtual void sleepMilliseconds(uint32_t ms) = 0;

        virtual uintptr_t getCurrentThreadId() = 0;
};