ProSoft Technology MVI69-ADM - Manual (Page 290)

CIP Messaging Library Functions MVI-ADM ♦ 'C' Programmable
Developer's Guide 'C' Programmable Application Development Module
Page 290 of 342 ProSoft Technology, Inc.
February 20, 2013
MVIcip_RegisterResetReqRtn
Syntax
int MVIcip_RegisterResetReqRtn( MVIHANDLE handle, MVICALLBACK
(*resetrequest_proc)( ) );
Parameters
handle handle returned by previous call to MVIcip_Open
resetrequest_proc pointer to reset request callback routine
Description
This function is used by an application to register a reset request callback
routine. Once registered, the backplane device driver will call resetrequest_proc
if a module reset request is received.
handle must be a valid handle returned from MVIcip_Open.
resetrequest_proc must be a pointer to a reset request callback function.
If the application does not register a reset request handler, receipt of a module
reset request will result in a software reset (that is, reboot) of the module. The
application may register a reset request callback in order to perform an orderly
shutdown, reset special hardware, or to deny the reset request.
Return Value
MVI_SUCCESS routine was registered successfully
MVI_ERR_NOACCESS handle does not have access
Example
MVIHANDLE handle;
// Register a reset request handler
MVIcip_RegisterResetReqRtn(handle, resetrequest_proc);
See Also
resetrequest_proc (page 288)