beautypg.com

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

Page 236

background image

API Library of Routines

Appendix B

MSG_WRITE_HANDLER

B-105

Handles a PLC-5 programmable-controller message-write instruction.

C Syntax

#include

unsigned MSG_WRITE_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 stores the write data.

buff_size

Size of the write buffer in bytes.

msg_num

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

items

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

<

234 bytes.

timeout

Timeout value in seconds. When using a value of CC_FOREVER
(defined in COPRO.H), this function keeps the write handler posted
until a message has been received.

MSG_WRITE_HANDLER