kernelv_get_axis_channel_number()

Prototype

KERNELV_RETURN

kernelv_get_axis_channel_number (unsigned short* chanNumbers,
unsigned long maxByteSize,
unsigned long* returnSize);

Description

By configuration or by axis replacement commands during an NC program, an axis can be moved by different CNC channels. By means of this function, the number of the channel moving the respective axis can be queried.

The following relationship exists between the channel number and the channel index:

Channel index = channel number –1

Parameter

Name	Type	Meaning
chanNumbers	unsigned short*	Pointer to the memory area for the channel numbers to be returned.
maxByteSize	unsigned long	Size of the memory area for the axis positions.
returnSize	unsigned long*	Number of bytes returned in positions.

Return values

Symbol	Value	Meaning
RET_FINISHED	0	The function was executed without error.
ERR_CNC_NOT_INIT	-3	The simulation CNC kernel was not yet initialised.
ERR_CNC_RET_MEMORY	-4	The return value(s) does/do not fit into the memory provided. In this case, the required memory is returned in the returnSize parameter.