Rockwell-automation 1747-PCINT API Software for 1746 I/O Bedienungsanleitung Seite 1

User ManualAPI Software for 1746 I/O PCI Interface(Cat. No. 1747-PCIDOS, -PCINT) Allen-Bradley

1–2 OverviewPublication 1747-6.5.3 June 1998The 1746 I/O PCI Interface APIUse the 1746 I/O PCI Interface API to develop the software interface between

6–46 Library of Routines OC_InitScannerPublication 1747-6.5.3 June 1998OC_InitScanner This function initializes the shared memory interface between th

OC_InitScanner Library of Routines 6–47Publication 1747-6.5.3 June 1998Return Value:Considerations:Supported in the DOS API library and the Windows NT

OC_OpenScanner Library of Routines 6–48Publication 1747-6.5.3 June 1998OC_OpenScanner OC_OpenScanner acquires access to the scanner device and sets a

OC_PetHostWatchdog Library of Routines 6–49Publication 1747-6.5.3 June 1998OC_PetHostWatchdog OC_PetHostWatchdog increments the host-to-scanner watchd

6–50 Library of Routines OC_PollScannerPublication 1747-6.5.3 June 1998OC_PollScanner OC_PollScanner reads module I/O interrupt, discrete input interr

OC_PollScanner Library of Routines 6–51Publication 1747-6.5.3 June 1998The data returned in the MsgData member array depends upon the value in MsgID:S

6–52 Library of Routines OC_ReadHostRetentive DataPublication 1747-6.5.3 June 1998OC_ReadHostRetentiveDataOC_ReadHostRetentiveData reads the host-rete

OC_ReadHostRetentive Data Library of Routines 6–53Publication 1747-6.5.3 June 1998Example:HANDLE Handle;BYTE retent_data[500];int retcode;retcode = OC

6–54 Library of Routines OC_ReadInputImagePublication 1747-6.5.3 June 1998OC_ReadInputImage OC_ReadInputImage reads the current input image from the s

OC_ReadInputImage Library of Routines 6–55Publication 1747-6.5.3 June 1998Return Value:Considerations:Supported in the DOS API library and the Windows

Overview 1–3Publication 1747-6.5.3 June 1998The Windows NT API library is a DLL and must be installed on the system in order to run an application whi

6–56 Library of Routines OC_ReadIOConfigFilePublication 1747-6.5.3 June 1998OC_ReadIOConfigFile OC_ReadIOConfigFile reads the configuration data that

OC_ReadModuleFile Library of Routines 6–57Publication 1747-6.5.3 June 1998OC_ReadModuleFile OC_ReadModuleFile reads a data file from a module.Syntax:i

6–58 Library of Routines OC_ReadModuleFilePublication 1747-6.5.3 June 1998Example:HANDLE Handle;WORD filedata[2];int retcode;retcode = OC_ReadModuleFi

OC_ReadOutputImage Library of Routines 6–59Publication 1747-6.5.3 June 1998OC_ReadOutputImage OC_ReadOutputImage reads the current output image from t

6–60 Library of Routines OC_ReadOutputImagePublication 1747-6.5.3 June 1998Example:HANDLE Handle;WORD outputdata[2];int retcode;retcode = OC_ReadOutpu

OC_ReadSRAM Library of Routines 6–61Publication 1747-6.5.3 June 1998OC_ReadSRAM OC_ReadSRAM reads data from the battery-backed user memory.Syntax:int

6–62 Library of Routines OC_ReadSRAMPublication 1747-6.5.3 June 1998Example:Byte buf[100]; /*buffer of 100 bytes of important data*/HANDLE handle;Word

OC_ResetScanner Library of Routines 6–63Publication 1747-6.5.3 June 1998OC_ResetScanner OC_ResetScanner generates a temporary hard reset to the scanne

6–64 Library of Routines OC_SetForcesPublication 1747-6.5.3 June 1998OC_SetForces OC_SetForces installs and removes input and output forces to the sca

OC_SetForces Library of Routines 6–65Publication 1747-6.5.3 June 1998Return Value:Considerations:Supported in the DOS API library and the Windows NT A

1–4 OverviewPublication 1747-6.5.3 June 1998Your application (the code you develop using the API) uses the dual port memory to communicate with the sc

6–66 Library of Routines OC_SetHostWatchdogPublication 1747-6.5.3 June 1998OC_SetHostWatchdog OC_SetHostWatchdog sets the host-to-scanner watchdog del

OC_SetInputUpdate Mode Library of Routines 6–67Publication 1747-6.5.3 June 1998OC_SetInputUpdateModeOC_SetInputUpdateMode controls how the scanner upd

6–68 Library of Routines OC_SetIOIdleStatePublication 1747-6.5.3 June 1998OC_SetIOIdleState OC_SetIOIdleState controls the state of I/O when the scann

OC_SetModuleInterrupt Library of Routines 6–69Publication 1747-6.5.3 June 1998OC_SetModuleInterrupt OC_SetModuleInterrupt enables, disables, or acknow

6–70 Library of Routines OC_SetOutputUpdate ModePublication 1747-6.5.3 June 1998OC_SetOutputUpdateModeOC_SetOutputUpdateMode controls how the scanner

OC_SetOutputUpdate Mode Library of Routines 6–71Publication 1747-6.5.3 June 1998Return Value:Considerations:Supported in the DOS API library and the W

6–72 Library of Routines OC_SetScanModePublication 1747-6.5.3 June 1998OC_SetScanMode OC_SetScanMode changes the scan mode of the scanner.Syntax:int O

OC_SetScanTime Library of Routines 6–73Publication 1747-6.5.3 June 1998OC_SetScanTime OC_SetScanTime sets the I/O scan time and I/O scan interval of t

6–74 Library of Routines OC_SetUserLEDStatePublication 1747-6.5.3 June 1998OC_SetUserLEDState OC_SetUserLEDState sets the state of a user-defined LEDS

OC_SetupPowerFail Action Library of Routines 6–75Publication 1747-6.5.3 June 1998OC_SetupPowerFailActionOC_SetupPowerFailAction registers the action t

Overview 1–5Publication 1747-6.5.3 June 1998If a non-recoverable fault occurs, reset the scanner (cycle power). Some possible non-recoverable faults i

6–76 Library of Routines OC_SetupPowerFail ActionPublication 1747-6.5.3 June 1998Return Value:Considerations:Supported in the DOS API library only.Exa

OC_WaitForDII Library of Routines 6–77Publication 1747-6.5.3 June 1998OC_WaitForDII Blocks the calling thread until a DII interrupt is received from t

6–78 Library of Routines OC_WaitForEosPublication 1747-6.5.3 June 1998OC_WaitForEos Blocks the calling thread until an end-of-scan (EOS) notification

OC_WaitForEos Library of Routines 6–79Publication 1747-6.5.3 June 1998Example:HANDLE handle;intrc;MSGBUF eosMSG/* Wait for 10 seconds for the EOS */rc

6–80 Library of Routines OC_WaitForEosDmdInPublication 1747-6.5.3 June 1998OC_WaitForEosDmdIn Blocks the calling thread until a demand input end-of-sc

OC_WaitForEosDmdIn Library of Routines 6–81Publication 1747-6.5.3 June 1998Example:HANDLE handle;intrc;MSGBUF eosMSG/* Request an input scan, but don’

6–82 Library of Routines OC_WaitForEosDmdOutPublication 1747-6.5.3 June 1998OC_WaitForEosDmdOut Blocks the calling thread until a demand output end-of

OC_WaitForEosDmdOut Library of Routines 6–83Publication 1747-6.5.3 June 1998Example:HANDLE handle;intrc;MSGBUF eosMSG/* Request an output scan, but do

6–84 Library of Routines OC_WaitForExtErrorPublication 1747-6.5.3 June 1998OC_WaitForExtError Blocks the calling thread until an extended error is rec

OC_WaitForIoInt Library of Routines 6–85Publication 1747-6.5.3 June 1998OC_WaitForIoInt Blocks the calling thread until a module interrupt is received

1–6 OverviewPublication 1747-6.5.3 June 1998Installing the Windows NT APITo install the Windows NT API, use the setup utility:1. Insert the API disket

6–86 Library of Routines OC_WriteHostRetentive DataPublication 1747-6.5.3 June 1998OC_WriteHostRetentiveDataOC_WriteHostRetentiveData writes data to t

OC_WriteIOConfigFile Library of Routines 6–87Publication 1747-6.5.3 June 1998OC_WriteIOConfigFile OC_WriteIOConfigFile writes the configuration data c

6–88 Library of Routines OC_WriteModuleFilePublication 1747-6.5.3 June 1998OC_WriteModuleFile OC_WriteModuleFile writes a data file to a module.Syntax

OC_WriteModuleFile Library of Routines 6–89Publication 1747-6.5.3 June 1998Example:HANDLE Handle;WORD filedata[2];int retcode;filedata[0] = 0x55AA;fil

6–90 Library of Routines OC_WriteOutputImagePublication 1747-6.5.3 June 1998OC_WriteOutputImage OC_WriteOutputImage updates the output image on the sc

OC_WriteOutputImage Library of Routines 6–91Publication 1747-6.5.3 June 1998Example:HANDLE Handle;WORD outputdata[2];int retcode;outputdata[0] = 0x55A

6–92 Library of Routines OC_WriteSRAMPublication 1747-6.5.3 June 1998OC_WriteSRAM OC_WriteSRAM wires data to the battery-backed user memorySyntax:int

Publication 1747-6.5.3 June 1998AppendixAError CodesIntroduction This appendix describes the error code data.Error Code Returned by API FunctionsMost

A–2 Error CodesPublication 1747-6.5.3 June 1998Extended Error CodesThe OC_GetExtendedError function returns error information in a structure of type O

Error Codes A–3Publication 1747-6.5.3 June 1998The error code data provides information specific to the cause of all extended errors, except 0xF0 (see

Overview 1–7Publication 1747-6.5.3 June 1998Installation DetailsThis section describes the actions the setup utility performs to install the API and O

A–4 Error CodesPublication 1747-6.5.3 June 1998If the extended error code is an internal scanner error (0xF0), the slot number is set to 0 and the fir

Publication 1747-6.5.3 June 1998AppendixBTesting Function CallsIntroduction Both the DOS API and the Windows NT API come with a utility program called

B–2 Testing Function CallsPublication 1747-6.5.3 June 1998Notes:

Allen-BradleyPublication Problem ReportIf you find a problem with our documentation, please complete and return this form.Pub. NameCat. No. Pub. No. P

Other CommentsPLEASE FOLD HERENO POSTAGE NECESSARY IF MAILED IN THE UNITED STATESBUSINESS REPLY MAILFIRST-CLASS MAIL PERMIT NO. 18235 CLEVELAND OHPOST

Publication 1747-6.5.3 – June 1998 PN 955132-74Copyright 1998 Allen-Bradley Company, Inc. Printed in USAAllen-Bradley, a Rockwell Automation Business

1–8 OverviewPublication 1747-6.5.3 June 1998Notes:

Publication 1747-6.5.3 June 1998Chapter2Using the APIIntroduction This chapter describes the API and how to use its components. For more information a

2–2 Using the APIPublication 1747-6.5.3 June 1998DOS ConsiderationsThe DOS API is as consistent as possible with APIs for other operating system platf

Using the API 2–3Publication 1747-6.5.3 June 1998Windows NT ConsiderationsDuring development, the application must be linked with an import library th

Important User InformationBecause of the variety of uses for the products described in this publication, those responsible for the application and use

2–4 Using the APIPublication 1747-6.5.3 June 1998Tools to Use The API functions support both Microsoft and Borland C compilers. The API disk includes

Using the API 2–5Publication 1747-6.5.3 June 1998Sample DOS MAKE file for Borland compilersThe following sample file shows how to use a Borland MAKE f

2–6 Using the APIPublication 1747-6.5.3 June 1998Sample DOS MAKE file for Microsoft compilersThe following sample file shows how to use a Microsoft MA

Using the API 2–7Publication 1747-6.5.3 June 1998Sample Windows NT MAKE file for Microsoft compilersThe following sample file shows how to use a Micro

2–8 Using the APIPublication 1747-6.5.3 June 1998!endif#-------------------------------------------# Compiler Options## -W3 Turn on warnings# -GB

Using the API 2–9Publication 1747-6.5.3 June 1998Sample Windows NT MAKE file for Borland compilersThe following sample file shows how to use a Borland

2–10 Using the APIPublication 1747-6.5.3 June 1998|clean: del *.exe del *.obj del *.map del *.librebuild: $(MAKE) -f sampleb.mak clean

Publication 1747-6.5.3 June 1998Chapter 3Developing ApplicationsIntroduction This chapter describes the proper programming sequence for your applicati

3–2 Developing ApplicationsPublication 1747-6.5.3 June 1998Programming SequenceFollow this programming sequence when you develop your application.Acc

Developing Applications 3–3Publication 1747-6.5.3 Junel 1998Initialize the scannerAfter the scanner is reset and performs its POST, the scanner waits

PrefacePublication 1747-6.5.3 June 1998Using This ManualWho Should Use this ManualUse this manual if you are responsible for developing control applic

3–4 Developing ApplicationsPublication 1747-6.5.3 June 1998The application can read the current I/O configuration with the OC_GetIOConfiguration func

Developing Applications 3–5Publication 1747-6.5.3 Junel 1998Scan I/OThe scanner provides two basic methods for scanning I/O: timed scans andon-demand

3–6 Developing ApplicationsPublication 1747-6.5.3 June 1998Programming Example for DOSThe following DOS example (sample.c on your API disk) shows how

Developing Applications 3–7Publication 1747-6.5.3 Junel 1998/*** Open the scanner */retcode = OC_OpenScanner( &Handle, 0, 0);if ( retcode != SUCC

3–8 Developing ApplicationsPublication 1747-6.5.3 June 1998/* ** Read switch position */retcode = OC_GetSwitchPosition( Handle, &swpos );if ( re

Developing Applications 3–9Publication 1747-6.5.3 Junel 1998/* ** Download the configuration to the scanner */retcode = OC_DownloadIOConfiguration( H

3–10 Developing ApplicationsPublication 1747-6.5.3 June 1998/* ** Read first Input word */retcode = OC_ReadInputImage( Handle, NULL, input_slot, 0,

Developing Applications 3–11Publication 1747-6.5.3 Junel 1998/************************************************************************** Name: Ioexit

3–12 Developing ApplicationsPublication 1747-6.5.3 June 1998Programming Example for Windows NTThe following Windows NT example (sample.c on your Wind

Developing Applications 3–13Publication 1747-6.5.3 Junel 1998 if (OC_GetExtendedError(OChandle, &exterr) == SUCCESS) { if ( exterr.E

Preface–2 Using This ManualPublication 1747-6.5.3 June 1998

3–14 Developing ApplicationsPublication 1747-6.5.3 June 1998/************************************************************************ * * Entry p

Developing Applications 3–15Publication 1747-6.5.3 Junel 1998 /* Reset the scanner */ printf("\nResetting the scanner..."); if (S

3–16 Developing ApplicationsPublication 1747-6.5.3 June 1998 /* Read auto-config */ if (SUCCESS != (rc = OC_GetIOConfiguration(OChandle, &

Developing Applications 3–17Publication 1747-6.5.3 Junel 1998 /* Set output update mode to always */ if (SUCCESS != (rc = OC_SetOutputUpdateMod

3–18 Developing ApplicationsPublication 1747-6.5.3 June 1998Handling Interrupt MessagesModules that communicate via discrete input interrupts or modu

Developing Applications 3–19Publication 1747-6.5.3 Junel 1998To determine the input and output image sizes, call OC_CreateIOConfiguration with a confi

3–20 Developing ApplicationsPublication 1747-6.5.3 June 1998Notes:

Publication 1747-6.5.3 June 1998Chapter 4Using the API StructuresIntroduction This chapter describes the structures the API uses. These structures are

4–2 Using the API StructuresPublication 1747-6.5.3 June1998OCSLOTCFGConfiguration information for a module. The mix and type codes together form a uni

Publication 1747-6.5.3 June 1998Chapter 5Configuring I/O ModulesIntroduction This chapter explains how to configure the I/O modules for your 1746 I/O

Publication 1747-6.5.3 June 1998Table of ContentsOverview Chapter 1Introduction. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

5–2 Configuring I/O ModulesPublication 1747-6.5.3 June 1998struct {BYTE mix; /* Module I/O Mix value */BYTE type; /* Module Type */BYTE InputSize; /*

Configuring I/O Modules 5–3Publication 1747-6.5.3 June 1998Using M0-M1 Files and G FilesThe 1746 I/O PCI Interface uses M0-M1 files and G files to dow

5–4 Configuring I/O ModulesPublication 1747-6.5.3 June 1998Supported I/O ModulesModule Name:aDescription: Class: Mix:bType:AMCI-1561 1 35 141203-SM1 C

Configuring I/O Modules 5–5Publication 1747-6.5.3 June 1998Module Name:aDescription: Class: Mix:bType:1746-IO4 2-Input 100/120 V ac 2-Output [RLY]0 8

5–6 Configuring I/O ModulesPublication 1747-6.5.3 June 1998Notes:

Publication 1747-6.5.3 June 1998Chapter 6Library of RoutinesIntroduction The MS-DOS API is a run-time library that can be linked with most industry st

6–2 Library of Routines OC_CalculateCRCPublication 1747-6.5.3 June 1998OC_CalculateCRC OC_CalculateCRC calculates a 16-bit CRC.Syntax:void OC_Calculat

OC_ClearFault Library of Routines 6–3Publication 1747-6.5.3 June 1998OC_ClearFault OC_ClearFault clears any fault condition of the scanner.Syntax:int

6–4 Library of Routines OC_CloseScannerPublication 1747-6.5.3 June 1998OC_CloseScanner This function must always be called before exiting the applicat

OC_ConfigureDII Library of Routines 6–5Publication 1747-6.5.3 June 1998OC_ConfigureDII OC_ConfigureDII allows an application to receive a message from

iiPublication 1747-6.5.3 June 1998Configuring I/O ModulesChapter 5Introduction. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

6–6 Library of Routines OC_ConfigureDIIPublication 1747-6.5.3 June 1998Return Value:Considerations:Supported in the DOS API library and the Windows NT

OC_CreateIO Configuration Library of Routines 6–7Publication 1747-6.5.3 June 1998OC_CreateIOConfigurationOC_CreateIOConfiguration creates a scanner co

6–8 Library of Routines OC_CreateIO ConfigurationPublication 1747-6.5.3 June 1998Example:OCIOCFG iocfg;int retcode, numslots, i;char module_name[] = ”

OC_DemandInputScan Library of Routines 6–9Publication 1747-6.5.3 June 1998OC_DemandInputScan OC_DemandInputScan forces the scanner to immediately perf

6–10 Library of Routines OC_DemandOutputScanPublication 1747-6.5.3 June 1998OC_DemandOutputScan OC_DemandOutputScan forces the scanner to immediately

OC_DownloadIO Configuration Library of Routines 6–11Publication 1747-6.5.3 June 1998OC_DownloadIOConfigurationOC_DownloadIOConfiguration downloads an

6–12 Library of Routines OC_DownloadIO ConfigurationPublication 1747-6.5.3 June 1998Considerations:Supported in the DOS API library and the Windows NT

OC_EnableEOSNotify Library of Routines 6–13Publication 1747-6.5.3 June 1998OC_EnableEOSNotify OC_EnableEOSNotify controls whether end-of-scan notifica

6–14 Library of Routines OC_EnableEOSNotifyPublication 1747-6.5.3 June 1998Return Value:Considerations:Supported in the DOS API library and the Window

OC_EnableForces Library of Routines 6–15Publication 1747-6.5.3 June 1998OC_EnableForces OC_EnableForces enables/disables forces for all inputs and out

iiiPublication 1747-6.5.3 June 1998OC_InitScanner . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-46OC_OpenS

6–16 Library of Routines OC_EnableForcesPublication 1747-6.5.3 June 1998Considerations:Supported in the DOS API library and the Windows NT API library

OC_EnableSlot Library of Routines 6–17Publication 1747-6.5.3 June 1998OC_EnableSlot OC_EnableSlot enables fine tuning of the I/O scanning process.Synt

6–18 Library of Routines OC_ErrorMsgPublication 1747-6.5.3 June 1998OC_ErrorMsg OC_ErrorMsg returns a descriptive text message associated with the API

OC_ExtendedErrorMsg Library of Routines 6–19Publication 1747-6.5.3 June 1998OC_ExtendedErrorMsg OC_ExtendedErrorMsg returns a descriptive text message

6–20 Library of Routines OC_ExtendedErrorMsgPublication 1747-6.5.3 June 1998Example:HANDLE Handle;OCEXTERR exterr;char *msg;int retcode;/* Should alre

OC_GetBatteryStatus Library of Routines 6–21Publication 1747-6.5.3 June 1998OC_GetBatteryStatus OC_GetBatteryStatus gets the current state of the batt

6–22 Library of Routines OC_GetDeviceInfoPublication 1747-6.5.3 June 1998OC_GetDeviceInfo OC_GeDeviceInfo returns information about the scanner device

OC_GetExtendedError Library of Routines 6–23Publication 1747-6.5.3 June 1998OC_GetExtendedError OC_GetExtendedError reads extended error information f

6–24 Library of Routines OC_GetExtendedErrorPublication 1747-6.5.3 June 1998Considerations:Supported in the DOS API library and the Windows NT API lib

OC_GetInputImage UpdateCounter Library of Routines 6–25Publication 1747-6.5.3 June 1998OC_GetInputImageUpdateCounterOC_GetInputImageUpdateCounter read

ivPublication 1747-6.5.3 June 1998

6–26 Library of Routines OC_GetInputImage UpdateCounterPublication 1747-6.5.3 June 1998

OC_GetIOConfiguration Library of Routines 6–27Publication 1747-6.5.3 June 1998OC_GetIOConfiguration OC_GetIOConfiguration queries the I/O rack about t

6–28 Library of Routines OC_GetIOConfigurationPublication 1747-6.5.3 June 1998Return Value:Considerations:Supported in the DOS API library and the Win

OC_GetLastFaultCause Library of Routines 6–29Publication 1747-6.5.3 June 1998OC_GetLastFaultCause OC_GetLastFaultCause retrieves the cause of the last

6–30 Library of Routines OC_GetMeasuredScan TimePublication 1747-6.5.3 June 1998OC_GetMeasuredScanTimeOC_GetMeasuredScanTime returns the maximum and l

OC_GetScannerInitInfo Library of Routines 6–31Publication 1747-6.5.3 June 1998OC_GetScannerInitInfo This function retrieves current information about

6–32 Library of Routines OC_GetScannerInitInfoPublication 1747-6.5.3 June 1998Example:HANDLE Handle;OCINIT scaninit;int retcode;retcode = OC_GetScanne

OC_GetScannerStatus Library of Routines 6–33Publication 1747-6.5.3 June 1998OC_GetScannerStatus OC_GetScannerStatus reads the current status of the sc

6–34 Library of Routines OC_GetScannerStatusPublication 1747-6.5.3 June 1998Example:HANDLE Handle;BYTE scansts;int retcode;retcode = OC_GetScannerStat

OC_GetScanner WatchdogCount Library of Routines 6–35Publication 1747-6.5.3 June 1998OC_GetScannerWatchdogCountOC_GetScannerWatchdogCount reads the con

Publication 1747-6.5.3 June 1988Chapter 1OverviewIntroduction This chapter provides an overview of the 1746 I/O PCI Interface and the API software. T

6–36 Library of Routines OC_GetStatusFilePublication 1747-6.5.3 June 1998OC_GetStatusFile OC_GetStatusFile reads a copy of the current scanner system

OC_GetStatusFile Library of Routines 6–37Publication 1747-6.5.3 June 19980/6 statusForces installed bitThis bit is set is forces have been installed.0

6–38 Library of Routines OC_GetStatusFilePublication 1747-6.5.3 June 19989 to 10 statusI/O interrupt enabledThese two words are bit-mapped to the 30 I

OC_GetStatusFile Library of Routines 6–39Publication 1747-6.5.3 June 1998Return Value:Considerations:Supported in the DOS API library and the Windows

6–40 Library of Routines OC_GetSwitchPositionPublication 1747-6.5.3 June 1998OC_GetSwitchPosition OC_GetSwitchPosition reads the current position of t

OC_GetTemperature Library of Routines 6–41Publication 1747-6.5.3 June 1998OC_GetTemperature OC_GetTemperature reads the current temperature of the 174

6–42 Library of Routines OC_GetUserJumper StatePublication 1747-6.5.3 June 1998OC_GetUserJumperStateOC_GetUserJumperState reads the state of the user

OC_GetUserLEDState Library of Routines 6–43Publication 1747-6.5.3 June 1998OC_GetUserLEDState OC_GetUserLEDState reads the status of one of the four u

6–44 Library of Routines OC_GetVersionInfoPublication 1747-6.5.3 June 1998OC_GetVersionInfo OC_GetVersionInfo retrieves the current version of the API

OC_GetVersionInfo Library of Routines 6–45Publication 1747-6.5.3 June 1998Example:HANDLE Handle;OCVERSIONINFO verinfo;int retcode;retcode = OC_GetVers