ProSoft Technology MVI69E-LDM - Manual (Page 79)

MVI69E-LDM ♦ "C" Programmable Contents
Linux Application Development Module Developer's Manual
ProSoft Technology, Inc. Page 79 of 130
August 21, 2014
5.4 Synchronization
MVI69_WaitForInputScan
Syntax
int MVI69_WaitForInputScan (MVI69HANDLE handle,
WORD timeout);
Parameters
handle
handle returned by previous call to MVI69_Open
timeout maximum number of milliseconds to wait for scan
Description
MVI69_WaitForInputScan allows an application to synchronize with the scan of the module's
input image. This function will return immediately after the input image has been read. This
function may also be used by a module application to determine if the backplane is active.
handle must be a valid handle returned from MVI69_Open. timeout specifies the number of
milliseconds that the function will wait for the input scan to occur.
Note: There is no distinction in teh MVI69E module between input and output scans. Therefore, the
MVI69_WaitForInputScan and MVI69_WaitForOutputScan functions will perform exactly the same function and
are interchangeable.
Return Value
MVI69_SUCCESS the input scan has occurred.
MVI69_ERR_NOACCESS handle does not have access
MVI69_ERR_TIMEOUT the timeout expired before an input scan occurred
Example
MVI69HANDLE handle;
/*wait here until input scan, 50ms timeout */
rc = MVI69_WaitForInputScan (Handle, 50);
if (rc == MVI69_ERR_TIMEOUT)
printf ("Message scan did not occur within 50 milliseconds\n");
else
printf ("Input scan has occurred\n");
See Also
MVI69_WaitForOutputScan