Library.SetConfiguredIoCount Method

Sets the number of configured I/O modules. If the actual number of detected real I/O modules is less than the number configured, simulated I/O modules will be generated during Library.Start to match the configured number.

Namespace:  IntervalZero.MaxRT.Ecat.Api.NetApi
Assembly:  IntervalZero.MaxRT.Ecat (in IntervalZero.MaxRT.Ecat.dll) Version: 1.0.0.0 (File version: 1.0.1)

Syntax

Copy
public EcatErrorCode SetConfiguredIoCount(
    EcatHandle mainDevice,
    uint count
)

Parameters

mainDevice

Type: EcatHandle
A handle to a MainDevice. To retrieve the corresponding handle, use CreateMainDevice or OpenMainDevice.

count

Type: UInt32
The number of configured I/O modules.

Return Value

EcatErrorCode is thrown when any of these errors occur:

Error code Meaning

ecatErrNoError

The function succeeded.

ecatErrWrongParameter

One of the following conditions occurred:

  • Parameter mainDevice is invalid.
  • Parameter count is invalid.

ecatErrMainDeviceNotReady

The MainDevice instance does not exist.

ecatErrWrongEnvironment

The MainDevice is not stopped. Calling this API after Library.Start is unsupported.

See Also: