# kernelv_get_acs0_command_positions()

## Prototype

KERNELV_RETURN | kernelv_get_acs0_command_positions (unsigned long* positions, unsigned long maxByteSize, unsigned long* returnSize);

## Description

The ACS command positions of all axes existing in the CNC are returned in an array. If an axis-specific command value transformation is configured for an axis, this function returns the untransformed command value for each specific axis.

Position values have a resolution of 0.1 µm for translatory axes or 1*10-4° for spindles or modulo axes.

The error code ERR_CNC_RET_MEMORY is returned if the memory provided by the calling application is not sufficient for returning all values.

The calling application must provide at least number of axes * sizeof(signed long int) bytes for returning of all position values.

The order of the axis positions in the returned array is equal to the configuration order of the axes.

## Parameter

Name | Type | Meaning
positions | unsigned long* | Pointer to the memory area for the axis positions 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. The number of bytes required is returned in the returnSize parameter.