LinuxCNC Documentation

SYNTAX

int rtapi_task_new(void (*_taskcode_)(void*), void *_arg_, int _prio_,
                   unsigned long _stacksize_, int _uses_fp_);
int rtapi_task_delete(int _task_id_);

ARGUMENTE

taskcode

Ein Zeiger auf die Funktion, die beim Starten der Aufgabe aufgerufen wird

arg

Ein Argument, das an die Funktion taskcode übergeben wird, wenn die Aufgabe gestartet wird

prio

Ein von rtapi_prio_xxxx zurückgegebener Wert für die Task-Priorität

uses_fp

Deprecated and ignored. All tasks now unconditionally save and restore floating point state. This parameter will be removed in a future version.

task_id

Eine Task-ID, die durch einen früheren Aufruf von rtapi_task_new zurückgegeben wurde

BESCHREIBUNG

rtapi_task_new creates but does not start a realtime task. The task is created in the "paused" state. To start it, call either rtapi_task_start for periodic tasks, or rtapi_task_resume for free-running tasks.

REALTIME CONSIDERATIONS

Aufruf nur aus dem Init/Cleanup-Code, nicht aus Echtzeit-Tasks.

RETURN VALUE

Gibt bei Erfolg eine positive ganzzahlige Aufgaben-ID zurück. Diese ID wird für alle nachfolgenden Aufrufe verwendet, die auf die Aufgabe reagieren müssen. Im Fehlerfall wird ein RTAPI-Statuscode zurückgegeben.

SIEHE AUCH

rtapi_prio(3), rtapi_task_start(3), rtapi_task_wait(3), rtapi_task_resume(3)