mirror of
https://github.com/switchbrew/libnx.git
synced 2025-06-21 12:32:40 +02:00
48 lines
1.1 KiB
C
48 lines
1.1 KiB
C
/**
|
|
* @file uevent.h
|
|
* @brief User-mode event synchronization primitive.
|
|
* @author plutoo
|
|
* @copyright libnx Authors
|
|
*/
|
|
#pragma once
|
|
#include "wait.h"
|
|
|
|
typedef struct UEvent UEvent;
|
|
|
|
/// User-mode event object.
|
|
struct UEvent {
|
|
Waitable waitable;
|
|
bool signal;
|
|
bool auto_clear;
|
|
};
|
|
|
|
/// Creates a waiter for a user-mode event.
|
|
static inline Waiter waiterForUEvent(UEvent* e)
|
|
{
|
|
Waiter wait_obj;
|
|
wait_obj.type = WaiterType_Waitable;
|
|
wait_obj.waitable = &e->waitable;
|
|
return wait_obj;
|
|
}
|
|
|
|
/**
|
|
* @brief Creates a user-mode event.
|
|
* @param[out] e UEvent object.
|
|
* @param[in] bool auto_clear Whether to automatically clear the event.
|
|
* @note It is safe to wait on this event with several threads simultaneously.
|
|
* @note If more than one thread is listening on it, at least one thread will get the signal. No other guarantees.
|
|
*/
|
|
void ueventCreate(UEvent* e, bool auto_clear);
|
|
|
|
/**
|
|
* @brief Clears the event signal.
|
|
* @param[in] e UEvent object.
|
|
*/
|
|
void ueventClear(UEvent* e);
|
|
|
|
/**
|
|
* @brief Signals the event.
|
|
* @param[in] e UEvent object.
|
|
*/
|
|
void ueventSignal(UEvent* e);
|