Isiupdateuserinterface() – Echelon ISI User Manual

Page 152

Advertising
background image

ISI Programmer’s Guide

150

IsiUpdateUserInterface()

void IsiUpdateUserInterface(IsiEvent

Event

, unsigned

Parameter

);

Provides status feedback from the ISI engine. These events are useful for
synchronizing the device’s user interface with the ISI engine. To receive

notification of ISI status events, override the IsiUpdateUserInterface() callback
function. The default implementation of IsiUpdateUserInterface() does nothing.

The ISI engine calls this function with the

Event

parameter set to one of the

values defined for the IsiEvent enumeration in Appendix A. Some of these
events carry a meaningful value in the

Parameter

argument, as detailed in the

IsiEvent definition.

You can use the

Event

parameter passed to the IsiUpdateUserInterface()

callback function to track the state of the ISI engine. This is a simple way to

determine which ISI function calls make sense at any time, and which ones don’t.

The following table lists this state information, based on the last

Event

value

provided with this callback, over possible ISI actions:

isiPending

isiPending

Host/

isiApproved

isiApproved

Host

isiNormal

IsiCancelEnrollment

9

9

IsiCreateEnrollment

9

9

IsiExtendEnrollment

9

9

IsiDeleteEnrollment

9

IsiLeaveEnrollment

9

IsiOpenEnrollment

9

IsiAcquireDomain

9

IsiStartDeviceAcquisition

9

IsiReturnToFactoryDefaults

9

9

9

9

Advertising