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

Page 225

Advertising
background image

API Library of Routines

Appendix B

MSG_READ_W_HANDLER

B-94

Handles a PLC-5 programmable-controller generated message-
read instruction.

C Syntax

#include <copro.h>

unsigned MSG_READ_W_HANDLER (variable,buff_size,msg_num,

items,timeout,cc_type,plc_type,

iostat)

short *variable;
unsigned buf_size;
unsigned msg_num;
unsigned items;
unsigned timeout;
unsigned cc_type;

unsigned plc_type;
int *iostat;

Parameters

variable

Address of a buffer that has the data to be read.

buff_size

Size of the read buffer in bytes.

msg_num

Number of the PLC-5 programmable controller message (0-31).

items

Number of data items to be read by the PLC-5 programmable controller.
The number and size of items cannot be greater than 240 bytes—e.g.,
maximum of 60 floating-point values of 4 bytes each = 240 bytes.

timeout

Timeout value in seconds. A value of CC_FOREVER (defined in
COPRO.H) will not return until the message has been processed.

MSG_READ_W_HANDLER

Advertising