Rockwell Automation 1771-DMC_DMC1_DMC4_DXPS Control Coprocessor User Manual - Manual (Page 186)

API Library of Routines
Appendix B
DTL_INIT
B-55
Creates and initializes the DTL data-definition table.
C Syntax
#include <copro.h>
unsigned DTL_INIT (max_defines)
unsigned max_defines;
Parameters
max_defines
Specifies the maximum number of entries in the data-definition table.
One entry is needed for each data item to be defined.
Important: Once you create the DTL data definition table, you cannot
change its size within the current process.
Returns
Status Symbolic Name Meaning
0 DTL_SUCCESS Operation successful
17 DTL_E_NO_MEM Not enough memory available
39 DTL_NO_REINIT DTL systemalready initialized
Description
Use the DTL_INIT function to initialize the data-table library before using
any DTL_ function calls.
Initializes internal data and creates a data-definition table by increasing the
memory area for the calling task .
Memory for the data-definition table is allocated dynamically when
DTL_INIT is called. Therefore, the maximum possible size of a given
task’s data-definition table depends on the amount of memory available in
the system’s free memory pool. A call to DTL_INIT will allocate
approximately 150 bytes per definition from the free-memory pool.
DTL_INIT