kernelv_ch_get_cont_visu_data()

Prototyp

KERNELV_RETURN

kernelv_ch_get_cont_visu_data (unsigned long int chanIndex,
                                                     unsigned char* pData,
                                                     unsigned long int maxByteSize,
                                                     unsigned long int* retLength);

Beschreibung

Liest die Konturvisualisierungsdaten eines Kanals aus. Das Format der zurückgelieferten Daten wird durch den Parameter P-STUP-00039 eingestellt. Zurückgeliefert wird eine Struktur des Typs CONTOUR_VISU, gefolgt von Strukturen des Typs COUNTOUR_VISU_DATA_V0 … _V8.

Sollte der vom Aufrufer bereitgestellte Speicher nicht zur Rückgabe der Struktur CONTOUR_VISU ausreichen wird ERR_CNC_RET_MEMORY zurückgegeben und in retLength die Mindestgröße des benötigten Speicherbereichs zurückgegeben.

Parameter

Name	Typ	Bedeutung
chanIndex	unsigned long	Kanalindex des Kanals von dem die Variable gelesen werden soll.
pData	unsigned char*	Zeiger auf den Speicherbereich für Rückgabewerte.
maxByteSize	unsigned long	Größe des Rückgabespeichers.
retLength	unsigned long*	Anzahl der in pData zurückgegebenen Bytes.

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. Im Parameter returnSize wird die Anzahl der benötigten Bytes zurückgegeben.