LV2
1.0.13
|
Data Fields | |
LV2_Worker_Schedule_Handle | handle |
Opaque host data. More... | |
LV2_Worker_Status(* | schedule_work )(LV2_Worker_Schedule_Handle handle, uint32_t size, const void *data) |
Request from run() that the host call the worker. More... | |
LV2_Worker_Schedule_Handle LV2_Worker_Schedule::handle |
Opaque host data.
LV2_Worker_Status(* LV2_Worker_Schedule::schedule_work) (LV2_Worker_Schedule_Handle handle, uint32_t size, const void *data) |
Request from run() that the host call the worker.
This function is in the audio threading class. It should be called from run() to request that the host call the work() method in a non-realtime context with the given arguments.
This function is always safe to call from run(), but it is not guaranteed that the worker is actually called from a different thread. In particular, when free-wheeling (e.g. for offline rendering), the worker may be executed immediately. This allows single-threaded processing with sample accuracy and avoids timing problems when run() is executing much faster or slower than real-time.
Plugins SHOULD be written in such a way that if the worker runs immediately, and responses from the worker are delivered immediately, the effect of the work takes place immediately with sample accuracy.
The data
MUST be safe for the host to copy and later pass to work(), and the host MUST guarantee that it will be eventually passed to work() if this function returns LV2_WORKER_SUCCESS.
handle | The handle field of this struct. |
size | The size of data . |
data | Message to pass to work(), or NULL. |