Dtl_write_w_idx – Rockwell Automation 1771-DMC_DMC1_DMC4_DXPS Control Coprocessor User Manual User Manual
Page 216

API Library of Routines
Appendix B
DTL_WRITE_W_IDX
B-85
Writes to any elements of a file, one element at a time, from the
control-coprocessor memory to the PLC-5 programmable controller using
only one data definition.
Important: To use this function call, you must have the versions of the
ABLIB.L and CORPRO.H files that accompany Series A Revision D
(1.20) or later of the Program Development Software. Contact Allen-
Bradley Global Technical Support Services at (216) 646-6800 if you need
these updates.
C Syntax
#include
unsigned DTL_WRITE_W_IDX (name_id, variable, iostat, index)
unsigned name_id;
void *variable;
unsigned *iostat;
unsigned index;
Parameters
name_id
DTL_C_DEFINE returns this handle when the data file to be written
is defined.
variable
The address of a buffer that contains the data to be written to the PLC-5
programmable controller. Ensure that the declared variable is the right
type to match the data size that was specified in DTL_C_DEFINE.
iostat
Returns a final completion status. Possible completion status values are:
Value
Meaning
0
DTL_SUCCESS = operation completed successfully
27
DTL_E_NOATMPT = I/O operation not attempted; see status variable for reason
xxx
¬
PCCC_E_xxx = operation refused by the PLCĆ5 programmable controller
¬
See Table B.A for PCCC errors.
index
This parameter specifies the element or structure level of the data-file
item to be written.
DTL_WRITE_W_IDX