Mitsubishi Electric MELSEC iQ-R Series - Page 88

86
3 DETAILS OF FUNCTION
3.2 MELSEC iQ-R Series Data Link Functions
mdrGetLabelInfo
This function acquires device information corresponding to label names.
■ Format
short mdrGetLabelInfo (long lPath, short sRoute, long lNetNo, long lIoNo, long lStNo, short sCPU, long lLbCnt, void* pLbLst,
long* plDevLst, unsigned long long* pullLbCode)
■ Argument
Device information assigned to labels specified to the label name array (pLbLst) is stored in a device specified to the device
name array (plDevLst) in a randomly selected device format listed below.
• One block comprises of three elements such as device type, start device number, and number of read points, and the total
number of blocks will be stored in the first element of the device name array (plDevLst).
Argument Name Description IN/OUT
lPath Path of channel Specify the path of the opened channel. IN
sRoute Access route Specify the access route to target module.
• 0: CC-Link IE Controller Network
• 1: CC-Link IE Field Network
•2: MELSECNET/H
• 3: CC-Link
• 4: Bus interface
IN
lNetNo Network number Specify the network number of target module.
Page 14 Argument specification
IN
lIoNo Start I/O number Specify the start I/O number divided by 16 of the target module.
Page 14 Argument specification
IN
lStNo Station number Specify the station number of target module.
Page 14 Argument specification
IN
sCPU CPU number Specify the CPU number of the target CPU module.
• 0: Control CPU specification
• 1 to 4: Multiple CPU specification
IN
lLbCnt Number of labels Specify the number of labels. (Up to 10240) IN
pLbLst Label name array Specify the storage address of label name for each label.
Specify a label name in Unicode (UTF-16).
IN
plDevLst Device name array Specify a device to store the acquired device information.
(Device information assigned to labels specified to the label name array
(pLbLst) is stored in a randomly selected device format.)
OUT
pullLbCode Label code A value to identify whether the label of a CPU module is changed or not is
stored.
(Whether the label setting is changed or not can be checked by whether this
value is changed or not. However, even when converting all in a CPU
module, the value changes.)
OUT
Storage position Description Block
plDevLst[0] Number of blocks 
plDevLst[1] Device type Block 1
plDevLst[2] Start device number
plDevLst[3] Number of read points
plDevLst[4] Device type Block 2
plDevLst[5] Start device number
plDevLst[6] Number of read points
 
plDevLst[3n+1] Device type Block n
plDevLst[3n+2] Start device number
plDevLst[3n+3] Number of read points