ProSoft Technology MVI69E-LDM - Manual (Page 74)

Contents MVI69E-LDM ♦ "C" Programmable
Developer's Manual Linux Application Development Module
Page 74 of 130 ProSoft Technology, Inc.
August 21, 2014
MVI69_WriteInputImage
Syntax
int MVI69_WriteInputImage (MVI69HANDLE handle,
WORD offset,
WORD length,
WORD *buffer);
Parameters
handle handle returned by previous call to MVI69_Open
offset word offset into output image at which to begin writing
length number of words to write
buffer pointer to buffer of data to be written to input image
Description
MVI69_WriteInputImage writes to the module's input image.
handle must be a valid handle returned from MVI69_Open .
buffer must point to a buffer of at least length words in size.
offset specifies the word in the output image to begin reading, and length specifies the
number of words to write. The error MVI69_ERR_BADPARAM will be returned if an attempt
is made to access the input image beyond the range configured for direct IO. If this error is
returned, no data will be written to the input image. See the
MVI69_GetIOConfig and
MVI69_SetIOConfig functions for more information.
The input image is written by the module and read by the control processor.
Return Value
MVI69_SUCCESS data was written to the input image successfully
MVI69_ERR_NOACCESS handle does not have access
MVI69_ERR_BADPARAM Parameter contains invalid value
Example
MVI69HANDLE handle;
WORD buffer[2];
int rc;
/* Write 2 words of data to the input image, starting with word 0*/
rc = MVI69_WriteInputImage (Handle, buffer, 0, 2);
if (rc != MVI69_SUCCESS)
printf("ERROR: MVI69_WriteInputImage failed");
See Also
MVI69_GetIOConfig
MVI69_SetIOConfig
MVI69_ReadOutputImage