ProSoft Technology MVI69-ADM - Manual (Page 289)

MVI-ADM ♦ 'C' Programmable CIP Messaging Library Functions
'C' Programmable Application Development Module Developer's Guide
ProSoft Technology, Inc. Page 289 of 342
February 20, 2013
10.7 CIP Special Callback Registration
MVIcip_RegisterFatalFaultRtn
Syntax
int MVIcip_RegisterFatalFaultRtn(MVIHANDLE handle, MVICALLBACK
(*fatalfault_proc)( ) );
Parameters
handle handle returned by previous call to MVIcip_Open
fatalfault_proc pointer to fatal fault callback routine
Description
This function is used by an application to register a fatal fault callback routine.
Once registered, the backplane device driver will call fatalfault_proc if a fatal fault
condition is detected.
handle must be a valid handle returned from MVIcip_Open.
fatalfault_proc must be a pointer to a fatal fault callback function.
A fatal fault condition will result in the module being taken offline; that is, all
backplane communications will halt. The application may register a fatal fault
callback in order to perform recovery, safe-state, or diagnostic actions.
Return Value
MVI_SUCCESS routine was registered successfully
MVI_ERR_NOACCESS handle does not have access
Example
MVIHANDLE handle;
// Register a fatal fault handler
MVIcip_RegisterFatalFaultRtn(handle, fatalfault_proc);
See Also
fatalfault_proc (page 286)