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

OC_SetInputUpdate Mode Library of Routines 6–67
Publication 1747-6.5.3 June 1998
OC_SetInputUpdate
Mode OC_SetInputUpdateMode controls how the scanner updates inputs.
Syntax:
int OC_SetInputUpdateMode(HANDLE handle, int mode);
Parameters:
Description:
This function does not affect output image scanning.
Return Value:
Considerations:
Supported in the DOS API library and the Windows NT API library
Example:
HANDLE Handle;
int retcode;
retcode = OC_SetInputUpdateMode( Handle, INUPD_NEVER );
/* Must use OC_DemandInputScan() function to obtain new input data */
Parameter: Description:
handle Must be a valid handle returned from OC_OpenScanner
mode
If mode is:
INUPD_NEVER the scanner does not scan inputs unless explicitly
requested by the OC_DemandInputScan function.
INUPD_ALWAYS the scanner continuously updates inputs on
every scan.
By default, the input update mode is INUPD_ALWAYS. A change in status
of the input update mode takes effect at the start of the next scan.
Name: Value: Description:
SUCCESS
0
conditional scan was set successfully
ERR_OCACCESS 2
handle does not have access to scanner
ERR_OCINIT 5 scanner has not been initialized; see OC_InitScanner
ERR_OCPARAM 8 parameter contains invalid value