Return value: considerations, Example – Rockwell Automation 1747-PCIS API Software - Open Controller User Manual

Page 122

Advertising
background image

Publication 1747-UM002A-US-P - June 2000

6-62 Library of Routines

Setting the output update mode to OUTUPD_CHANGE allows the
host application to signal the scanner to write outputs by calling
OC_WriteOutputImage. This setting allows the scanner’s minimum
scan time to be reduced (since it is only scanning inputs most of the
time), and is provided as a performance enhancement.

Setting the output update mode to OUTUPD_ALWAYS forces the
scanner to write outputs from the output image on every scan.

Return Value:

Considerations:

Supported in the DOS API library and the Windows NT API library

Example:

HANDLE

Handle;

int

retcode;

retcode = OC_SetOutputUpdateMode( Handle, OUTUPD_NEVER );

/* Must use OC_DemandOutputScan() function to send new output

data */

Name:

Value:

Description:

SUCCESS

0

conditional scan was set successfully

ERR_OCACCESS

2

handle

does not have access to the scanner

ERR_OCINIT

5

scanner has not been initialized, see OC_InitScanner

ERR_OCPARAM

8

parameter contains invalid value

Advertising
This manual is related to the following products: