RtecatOverrideSubDevicePdoConfiguration
RtecatOverrideSubDevicePdoConfiguration changes the input and output PDO lengths of a SubDevice. This can be used to programmatically configure a SubDevice.
Syntax
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: