kernelv_get_axis_channel_number()

Prototype

KERNELV_RETURN

kernelv_get_axis_channel_number(unsigned short int* chanNumbers,
unsigned long int maxByteSize,
unsigned long int* 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 int*	Pointer to the memory area for the channel numbers to be returned.
maxByteSize	unsigned long int	Size of the memory area for the channel numbers.
returnSize	unsigned long int*	Number of configured channels * sizeof(unsigned short int).

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.