kernelv_ch_get_finished_nc_lines()

Prototyp

KERNELV_RETURN

kernelv_ch_get_finished_nc_lines(unsigned long int chanIndex,
                                         KERNELV_NC_LINE_DATA *ncLineData,
                                           unsigned long int maxByteSize,
                                           unsigned long int* returnLength);

Beschreibung

Gibt die während des letzten Aufrufes von kernelv_do_cycle() für den angegebenen Kanal ausgeführten NC-Zeilen zurück. Es können bis zu 20 NC-Sätze pro Aufruf von kernelv_do_cycle() abgearbeitet werden.

Zurückgegeben wird ein Array von Strukturen des Typs KERNELV_NC_LINE_DATA.

Die Anzahl der zurückgegebenen Einträge kann durch returnLength/sizeof(KERNELV_NC_LINE_DATA) berechnet werden.

Der Aufbau der Struktur ist im Abschnitt Struct KERNELV_NC_LINE_DATA beschrieben.

Parameter

Name	Typ	Bedeutung
chanIndex	unsigned long	Kanalindex
ncLineData	KERNELV_NC_LINE_DATA*	Zeiger auf den Speicherbereich, in den die Daten der abgearbeiteten NC-Zeilen geschrieben werden sollen.
maxByteSize	unsigned long	Größe des bereitgestellten Speicherbereiches in Byte.
returnLength	unsigned long*	Zeiger auf den Speicherbereich, in den die Anzahl der tatsächlich zurückgelieferten Bytes geschrieben werden soll.

Rückgabewerte

Symbol	Wert	Bedeutung
RET_FINISHED	0	Die Funktion wurde fehlerfrei durchgeführt.
ERR_INVALID_CHAN	-1	Der übergebene Kanalindex ist größer als die Anzahl der konfigurierten Kanäle - 1
ERR_CNC_NOT_INIT	-3	Der Simulations-CNC-Kern ist noch nicht initialisiert.
ERR_CNC_RET_MEMORY	-4	Der oder die Rückgabewerte passen nicht in den bereitgestellten Speicher. In diesem Falle wird in returnLength die Anzahl der tatsächlich benötigten Bytes zurückgeliefert