Dtl_size – Rockwell Automation 1771-DMC_DMC1_DMC4_DXPS Control Coprocessor User Manual User Manual

Page 207

Advertising
background image

API Library of Routines

Appendix B

DTL_SIZE

B-76

Gets the size of memory necessary to store the contents of a data item in
control coprocessor format.

C Syntax

#include <copro.h>

unsigned DTL_SIZE (name_id, size)

unsigned name_id;

unsigned *size;

Parameters

name_id

The handle returned by DTL_C_DEFINE when the data item
was defined.

size

Size (in bytes) required for the data item that is returned. Zero is
returned if the data item is undefined.

Returns

Status

Symbolic Name

Meaning

0

DTL_SUCCESS

Operation successful

19

DTL_E_NOINIT

Definition table not initialized

20

DTL_E_BADID

Definition ID out of range

32

DTL_E_NODEF

No such data item defined

Description

Use DTL_SIZE to determine the amount of control-coprocessor memory
necessary to store a copy of the previously defined block of data.

DTL_SIZE

Advertising