Rockwell Automation 1747-PCIS API Software - Open Controller - Manual (Page 130)

Publication 1747-UM002A-US-P - June 2000
6-70 Library of Routines
OC_WaitForEosDmdIn Blocks the calling thread until a demand input end-of-scan (EOS)
notification is received from the scanner or
msTimeout milliseconds
have elapsed.
Syntax:
int OC_WaitForEosDmdIn(HANDLE handle,
DWORD msTimeout)
Parameters:
Description:
If a demand input EOS message has been received since the last
OCMSG_EOS_DMDIN message was retrieved with the
OC_PollScanner function, OC_WaitForEosDmdIn returns SUCCESS
immediately.
You can use this function to synchronize a control application with
the I/O scan. See the OC_EnableEOSNotify and
OC_DemandInputScan functions.
Return Value:
Considerations:
Supported in the Windows NT API library only.
Example:
HANDLE handle;
intrc;
MSGBUF eosMSG
/* Request an input scan, but don’t wait */
OC_DemandInputScan(handle, OCNOWAIT);
/* Could have other code here */
Parameter: Description:
handle Must be a valid handle returned from OC_OpenScanner
msTimeout Specifies the number of milliseconds to wait
Set to INFINITE to wait forever
Name: Value: Description:
SUCCESS 0 demand input EOS message was received
ERR_RESPONSE 10 msTimeout milliseconds elapsed without an EOS
ERR_OCACCESS 2
handle
does not have access to scanner