# kernelv_ch_suspend()

## Prototyp

KERNELV_RETURN | kernelv_ch_suspend (unsigned long int chanIndex);

## Beschreibung

Das aktuell im Kanal laufende Programm wird angehalten. Der Kanalzustand wechselt nach SIMU_CNC_STATE_HOLD.

Das Anhalten eines Programms ist nur möglich, wenn im Kanal gerade ein NC-Programm abgearbeitet wird, also wenn sich der Kanal im Zustand SIMU_CNC_STATE_ACTIVE befindet. Wird die Funktion aufgerufen, während sich der Kanal in einem anderen Zustand befindet, gibt die Funktion den Wert ERR_INVALID_STATE zurück.

## Parameter

Name | Typ | Bedeutung
chanIndex | unsigned long | Kanalindex des Kanals der angehalten werden soll.

## Rückgabewerte

Symbol | Wert | Bedeutung
RET_FINISHED | 0 | Die Funktion wurde fehlerfrei durchgeführt.
RET_BUSY | 1 | Die Funktion wird gerade ausgeführt, ist aber noch nicht abgeschlossen. Die API-Funktion muss weiter aufgerufen werden.
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_INVALID_STATE | -5 | Der CNC-Kanal ist im falschen Zustand, um eine Funktion auszuführen.