ProSoft Technology MVI69-ADM User Manual

Page 297

Advertising
background image

MVI-ADM ♦ 'C' Programmable

CIP Messaging Library Functions

'C' Programmable Application Development Module

Developer's Guide

ProSoft Technology, Inc.

Page 297 of 342

February 20, 2013

MVIcip_GetSetupMode

Syntax

int MVIcip_GetSetupMode(MVIHANDLE handle, int *mode);

Parameters

handle

handle returned by previous call to MVIcip_Open

mode

pointer to an integer that is set to 1 if the Setup Jumper is
installed, or 0 if the Setup Jumper is not installed.

Description
This function queries the state of the Setup Jumper.

handle must be a valid handle returned from MVIcip_Open.

mode is a pointer to an integer. When this function returns, mode will be set to 1
if the module is in Setup Mode, or 0 if not.

If the Setup Jumper is installed, the module is considered to be in Setup Mode.

It may be useful for an application to detect Setup Mode and perform special
configuration or diagnostic functions.

Return Value

MVI_SUCCESS

no errors were encountered

MVI_ERR_NOACCESS

handle does not have access

Example

MVIHANDLE handle;
int mode;
MVIcip_GetSetupMode(handle, &mode);
if (mode)
// Setup Jumper is installed - perform configuration/diagnostic
else
// Not in Setup Mode - normal operation

Advertising