kernelv_startup_instance()

Prototyp

KERNELV_RETURN

kernelv_startup_instance (unsigned long cycleTime,
                           char* startupFile
                           char* instancePrefix);

Beschreibung

Simulations-CNC starten:

Mit dieser Funktion ist es möglich, auf einem Computer mehrere Applikationen laufen zu lassen. Jede nutzt eine einzelne und damit eigene Instanz der kernelv-DLL. Hierzu muss im Aufrufparameter instancePrefix eine computerweit eindeutige Instanzkennung übergeben werden.

Die maximale Länge der Zeichenkette, die als Instanzkennung übergeben werden darf ist durch die Konstante KERNELV_INSTANCE_PREFIX_MAX_LEN definiert. Falls eine längere Zeichenkette übergeben wird, wird der Hochlauf nicht durchgeführt und die Funktion gibt den Wert ERR_PREFIX_TOO_LONG (-23) zurück.

Es ist nicht möglich, innerhalb einer Applikation mehrere Instanzen der kernelv-DLL laufen zu lassen.

Parameter

Name

Typ

Bedeutung

cycleTime

unsigned long

Zykluszeit in us..

startupFile

char *

Pfad und Name des Startup-Files.

instancePrefix

char *

Eindeutige Instanzkennung.

Rückgabewerte

Symbol

Wert

Bedeutung

RET_FINISHED

0

Die Funktion wurde fehlerfrei durchgeführt.

ERR_DOUBLE_KERNEL

-6

Es läuft bereits eine Instanz der Simulations-CNC.

ERR_SHM_STARTUP

-7

Beim Start des CNC-Kerns konnten intern verwendete Shared memories nicht angelegt werden.

ERR_STARTUP

-8

Beim Start der Simulations-CNC ist ein Fehler aufgetreten. Mögliche Ursachen sind fehlende Parameterlisten oder fehlerhafte Einträge in Parameterlisten.

ERR_NO_LICENSE

-17

Es wurde keine Lizenz für die Verwendung der kernelv-DLL gefunden.

ERR_REGISTRY_ACCESS

-19

Beim Versuch Werte aus der Windows-Registry zu lesen ist ein Fehler aufgetreten.

ERR_PREFIX_TOO_LONG

-23

Beim Aufruf der Funktion kernelv_startu_prefix() ist die übergebene Instanzkennung zu lang, sodass die intern generierten Namen für die verwendeten Shared Memories nicht mehr in den dafür vorgesehenen Speicher passen.

ERR_STARTUP_CHAN_INIT

-31

Beim Start der kernelev-Dll konnte die Initialisierung der konfigurierten NC-Kanäle nicht durchgeführt werden.

Hinweis

notice

Abhängig von der Achs- und Kanalanzahl der verwendeten Konfiguration kann der Start des CNC-Kerns 20 - 30 Sekunden dauern.