ProSoft Technology MVI56E-LDM - Manual (Page 182)

CIP API Functions ControlLogix Platform ♦ "C" Programmable
Developer's Manual Linux Application Development Module
Page 176 of 264 ProSoft Technology, Inc.
March 12, 2014
OCXcip_GetVersionInfo
Syntax
int OCXcip_GetVersionInfo (OCXHANDLE apihandle,
OCXCIPVERSIONINFO *verinfo);
Parameters
apihandle handle returned by previous call to OCXcip_Open
verinfo Pointer to structure of type OCXCIPVERSIONINFO
Description
OCXcip_GetVersionInfo retrieves the current version of the API Library, BPIE,
and the backplane device driver. The information is returned in the structure
verinfo
.
apihandle
must be a valid handle returned from
OCXcip_Open
or
OCXcip_ClientOpen
.
The
OCXCIPVERSIONINFO
structure is defined as follows:
typedef struct tagOCXCIPVERSIONINFO
{
WORD APISeries; //API series
WORD APIRevision; //API revision
WORD BPEngSeries; //Backplane engine series
WORD PEngineRevision; //Backplane engine revision
WORD BPDDSeries; //Backplane device driver series
WORD BPDDRevision; //Backplane device driver revision
} OCXCIPVERSIONINFO;
Return Value
OCX_SUCCESS ID object was retrieved successfully
OCX_ERR_NOACCESS apihandle does not have access
Example
OCXHANDLE apihandle;
OCXCIPVERSIONINFO verinfo;
/* print version of API library */
OCXcip_GetVersionInfo (Handle, &verinfo);
printf ("Library Series %d, Rev %d\n",
verinfo.APISeries, verinfo.APIRevision);
printf ("Driver Series %d, Rev &d\n",
verinfo.BPDDSeries, verinfo.BPDDRevsion);