ProSoft Technology MVI69-ADM - Manual (Page 275)

MVI-ADM ♦ 'C' Programmable CIP Messaging Library Functions
'C' Programmable Application Development Module Developer's Guide
ProSoft Technology, Inc. Page 275 of 342
February 20, 2013
10.5 CIPConnect
®
Data Transfer
MVIcip_WriteConnected
Syntax
int MVIcip_WriteConnected(MVIHANDLE handle, MVIHANDLE connHandle, BYTE
*dataBuf, WORD offset,WORD dataSize );
Parameters
handle handle returned by previous call to MVIcip_Open
connHandle handle of open connection
dataBuf pointer to data to be written
offset offset of byte to begin writing
dataSize number of bytes of data to write
Description
This function is used by an application to update data being sent on the open
connection specified by connHandle.
Handle must be a valid handle returned from MVIcip_Open.
ConnHandle must be a handle passed by the connect_proc callback function.
Offset is the offset into the connected data buffer to begin writing.
DataBuf is a pointer to a buffer containing the data to be written.
DataSize is the number of bytes of data to be written.
Note: For Assembly Instance 1, the first 4 bytes of the ControlLogix input image table are
overwritten with "FF" (hex) when the connection is not open or broken.
Return Value
MVI_SUCCESS data was updated successfully
MVI_ERR_NOACCESS handle does not have access
MVI_ERR_BADPARAM connHandle or dataSize is invalid
Example
MVIHANDLE handle;
MVIHANDLE connHandle;
BYTE buffer[128];
// Write 128 bytes to the connected data buffer
MVIcip_WriteConnected(handle, connHandle, buffer, 0, 128 );
See Also
MVIcip_ReadConnected (page 276)