kernelv_set_call_ratio()

Prototyp

KERNELV_RETURN

kernelv_set_call_ratio (unsigned short int dec_calls,
                                     unsigned short  int interpolator_calls);

Beschreibung

Legt das Verhältnis von Decoder-Aufrufen zu Interpolator-Aufrufen fest. Pro Aufruf von kernelv_do_cycle() wird ein Interpolatoraufruf durchgeführt. In vielen Echtzeitumgebungen kann die Zykluszeit für die Bahnplanungs-Task unabhängig von der Interpolator-Zykluszeit eingestellt werden. Mit dieser Funktion kann das Verhältnis von Bahnplanungszyklen zu Interpolatorzyklen für die kernelv-DLL eingestellt werden.

Ein Verhältnis von 5 Bahnplanungsaufrufen zu 2 Interpolatoraufrufen wird durch kernelv_set_call_ratio(5, 2) erreicht.

Die Parameter dec_calls und interpolator_calls dürfen beide nicht 0 sein, das Verhältnis der beiden Parameter muss im Bereich [0,05 , 20] liegen.

Parameter

Name

Typ

Bedeutung

dec_calls

unsigned short

Anzahl der Bahnplanungszyklen.

interpolator_calls

unsigned short

Anzahl der Interpolatorzyklen.

Rückgabewerte

Symbol

Wert

Bedeutung

RET_FINISHED

0

Die Funktion wurde fehlerfrei durchgeführt.

ERR_INVALID_
PARAMETER

-30

Einer der übergebenen Parameter ist ungültig. Es gelten die folgenden Bedingungen:

dec_calls, interpolator_calls <> 0

0,05 ≤ dec_calls/interpolator_calls ≤ 20.