”Variable handle by name” function

Available as of Build V3.1.3132.0 or V4.29.0

IndexGroup: IdxGrp = 0x122300 + Channel ID

Index offset: IdxOffs = 0x4C

Variable description

This function supplies the associated variable description for specified variable names.

Transfer parameters: (here with stream offset specified):

0

Variable name with variable type and zero termination

e.g. V.G.FEEDRATE

where

Contents

Type

Size

Variable name

STRING

variable, max. 256 bytes

=> stream length max. 256 bytes

Return value (here with stream offset specified):

0

4

8

12

16

(20)

(24)

...

Handle on the variable

Variable type

Access

Size

Number of array dimensions m

Number of elements in dimension 1

Number of elements in dimension 2

...

where

Contents

Variable type

Size

Handle on the variable

UNS32

fixed, 4 bytes

Variable type

Enumeration (UNS32) (*)

fixed, 4 bytes

Access

Enumeration (UNS32)

1 = READ_ONLY

2 = READ_WRITE

fixed, 4 bytes

Size

UNS32

fixed, 4 bytes

Number of array dimensions m

UNS32

(= 0, elementary variable)

fixed, 4 bytes

Number of elements
index: 0 – (n-1) per array dimension

UNS32

variable, 4 bytes * m

=> stream length 276 bytes + number of array dimensions n * 4 bytes, max. 2048 bytes

(*) Enumeration for variable type:

1 = BOOLEAN

4 = SGN16

7 = UNS32

2 = SGN08

5 = UNS16

8 = REAL64

3 = UNS08

6 = SGN32

9 = STRING