Interface EventDriverEvents
Cross-thread notifications
interface EventDriverEvents
;
"Events" can be used to wake up the event loop of a foreign thread. This is the basis for all kinds of thread synchronization primitives, such as mutexes, condition variables, message queues etc. Such primitives, in case of extended wait periods, should use events rather than traditional means to block, such as busy loops or kernel based wait mechanisms to avoid stalling the event loop.
Properties
| Name | Type | Description |
|---|---|---|
userData[set]
|
T | Retrieves a reference to a user-defined value associated with a descriptor. |
Methods
| Name | Description |
|---|---|
addRef
(descriptor)
|
Increments the reference count of the given event. |
cancelWait
(event, on_event)
|
Cancels an ongoing wait operation. |
create
()
|
Creates a new cross-thread event. |
isValid
(handle)
|
Determines whether the given event handle is valid. |
releaseRef
(descriptor)
|
Decrements the reference count of the given event. |
trigger
(event, notify_all)
|
Triggers an event owned by the current thread. |
trigger
(event, notify_all)
|
Triggers an event possibly owned by a different thread. |
wait
(event, on_event)
|
Waits until an event gets triggered. |
rawUserData
(descriptor, size, initialize, destroy)
|
Low-level user data access. Use userData instead.
|