GetControlword()

GetControlword() 1:

This method is used to read the control word of an I/O output element.

Syntax:

METHOD GetControlword : HRESULT
VAR_INPUT
    nDriveControlWord:        REFERENCE TO UINT;
END_VAR

GetControlword() 2: Return value

Name

Type

Description

GetControlword

HRESULT

Return value with feedback on the success of the execution.

The return value of the method is of type HRESULT. The following return values are to be expected.

E_AdsErr

Return value

Cause

DEVICE_ERROR

0x9B00 0700

The I/O element is in error state.

DEVICE_SYMBOLNOTFOUND

0x9B00 0710

The transferred reference is invalid.

DEVICE_INCOMPATIBLE

0x9B00 070E

The variable type of the transferred structure does not match the I/O element.

DEVICE_SRVNOTSUPP

0x1B00 0701

Function is not supported by the I/O element.

Notice This return value is not marked as an error!

DEVICE_NOERR

0x1B00 000

Execution was successful.

GetControlword() 3: Inputs

Name

Type

Description

nDriveControlWord

REFERENCE TO UINT

Reference to a variable to which the channel state is to be written.

Requirements

Development environment

Target platform

PLC libraries to include

TwinCAT v3.1.4024.35

PC or CX (x64, x86)

Tc3_PlasticFunctions v3.12.4.26 or higher