RtecatOverrideSubDevicePdoConfiguration

RtecatOverrideSubDevicePdoConfiguration changes the input and output PDO lengths of a SubDevice. This can be used to programmatically configure a SubDevice.

Syntax

Copy
RTECAT_ERROR RtecatOverrideSubDevicePdoConfiguration(
  [in]    RTECAT_HANDLE SubDevice,
  [in]    ULONG InputLength,
  [in]    ULONG OutputLength
);

Parameters

[in] SubDevice

A handle to a SubDevice. To retrieve the corresponding handle, use RtecatOpenSubDeviceByIndex, RtecatOpenSubDeviceByStationAddress, or RtecatOpenSubDeviceByExplicitId.

[in] InputLength

The length of a PDO input data.

[in] OutputLength

The length of a PDO output data.

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 SubDevice is invalid.

ecatErrMainDeviceNotReady

The MainDevice is not ready.

ecatErrWrongEnvironment

The link has not started.

ecatErrWrongMainDeviceStatus

The command is not usable in the current MainDevice state.

Remarks

RtecatOverrideSubDevicePdoConfiguration 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: