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

OC_WaitForDII Library of Routines 6–77
Publication 1747-6.5.3 June 1998
OC_WaitForDII Blocks the calling thread until a DII interrupt is received from the scanner or
msTimeout milliseconds have elapsed.
Syntax:
int OC_WaitForDII(HANDLE handle, DWORD msTimeout)
Parameters:
Description:
If a DII has been received since the last OCMSG_DIINT message was retrieved with the OC_PollScanner
function, OC_WaitForDII returns SUCCESS immediately.
Return Value:
Considerations:
Supported in the Windows NT API library only.
Example:
HANDLE handle;
intrc;
MSGBUF diiMSG
/* Wait for 10 seconds for a DII */
rc = OC_WaitForDII(handle, 10000);
switch(rc) {
case SUCCESS:/* got a DII */
/* fetch the DII message */
OC_PollScanner (handle,OCMSG_DIINT,&diiMSG);
break;
case ERR_OCRESPONSE:/* timed out */
printf(“\nTimed out waiting for DII\n”);
break;
default;
printf(“\nError!\n”);
break;
}
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
a DII was received
ERR_RESPONSE 10
msTimeout milliseconds elapsed without a DII
ERR_OCACCESS 2
handle does not have access to scanner