Rockwell Automation 1747-PCINT API Software for 1746 I/O - Manual (Page 67)

OC_EnableEOSNotify Library of Routines 6–13
Publication 1747-6.5.3 June 1998
OC_EnableEOSNotify OC_EnableEOSNotify controls whether end-of-scan notification messages are
generated by the scanner.
Syntax:
int OC_EnableEOSNotify(HANDLE handle, int mode);
Parameters:
Description:
There are three types of end-of-scan messages:
End-of-scan messages are generated from the scanner to the API via interrupts after each scan. The scan
rate is controlled by the OC_SetScanTime function and end-of-scan interrupts are generated at the scan
rate. Enabling end-of-scan messages can affect the performance of the application due to the overhead
incurred in processing these interrupts. An alternative method to synchronize with the scanner’s I/O scan
is to monitor the scanner watchdog register, which is incremented at the end of each timed I/O scan. See
OC_GetScannerWatchdogCount.
Parameter: Description:
handle Must be a valid handle returned from OC_OpenScanner
mode
If mode is:
EOSMSG_ENABLE the scanner generates an end-of-scan
message
after each scan. Use the OC_PollScanner
function
to retrieve end-of-scan messages.
EOSMSG_DISABLE the scanner does not generate End-of-
scan
messages. End-of-scan messages are
disabled
after the scanner has been reset.
This type of message: Is generated after:
OCMSG_EOS_DMDIN a OC_DemandInputScan command has completed
OCMSG_EOS_DMDOUT a OC_DemandOutputScan command has completed
OCMSG_EOS each timed I/O scan