Rockwell Automation Allen-Bradley ControlLogix 1756-MVI - Page 81

Publication 1756-RM004B-EN-P - October 2000
CIP Messaging API 4-29
MVIcip_GetVersionInfo
Syntax:
int MVIcip_GetVersionInfo(MVIHANDLE handle,
MVICIPVERSIONINFO *verinfo);
Parameters:
handle handle returned by previous call to MVIcip_Open
verinfo pointer to structure of type MVICIPVERSIONINFO
Description:
MVIcip_GetVersionInfo retrieves the current version of the API library
and the backplane device driver. The information is returned in the
structure
verinfo . handle must be a valid handle returned from
MVIcip_Open.
The MVICIPVERSIONINFO structure is defined as follows:
typedef struct tagMVICIPVERSIONINFO
{
WORD APISeries; /*API series */
WORD APIRevision; /* API revision */
WORD BPDDSeries; /* Backplane device driver series */
WORD BPDDRevision; /* Backplane device driver revision */
} MVICIPVERSIONINFO;
Return Value:
MVI_SUCCESS version information was read successfully
MVI_ERR_NOACCESS
handle does not have access
Example:
MVIHANDLE Handle;
MVICIPVERSIONINFO verinfo;
/* print version of API library */
MVIcip_GetVersionInfo(Handle,&verinfo);
printf(“Library Series %d, Rev %d\n”, verinfo.APISeries, verinfo.APIRevision);
printf(“Driver Series %d, Rev %d\n”, verinfo.BPDDSeries,
verinfo.BPDDRevision);