RtecatForceAxisSecondEncoder

RtecatForceAxisSecondEncoder writes the secondary encoder's position of a simulated axis.

Syntax

Copy
RTECAT_ERROR RtecatForceAxisSecondEncoder(
  [in]    RTECAT_HANDLE Axis,
  [in]    int Value
);

Parameters

[in] Axis

A handle to an axis. To retrieve the corresponding handle, use RtecatOpenAxisByIndex or RtecatOpenAxisByLocation.

[in] Value

An int value to write that represents the secondary encoder's position of a simulated axis.

Return Values

The function returns an RTECAT_ERROR value. If the function succeeds, it returns ecatErrNoError. If the function fails, it returns a different value.

Possible return values:

Return value Meaning

ecatErrNoError

The function succeeded.

ecatErrWrongParameter

Parameter Axis is invalid.

ecatErrMainDeviceNotReady

The MainDevice is not ready.

ecatErrWrongEnvironment

The axis is not a simulated one.

Remarks

RtecatForceAxisSecondEncoder is a synchronous function that executes immediately and returns a result upon completion.

Requirements

Minimum supported version Header Library

wRTOS 1.0 SDK

RtecatApi.h

RtecatApi_W64.lib (Windows), RtecatApi.lib (RTSS)

See Also: