ProSoft Technology MVI69-ADM - Manual (Page 232)

Backplane API Functions MVI-ADM ♦ 'C' Programmable
Developer's Guide 'C' Programmable Application Development Module
Page 232 of 342 ProSoft Technology, Inc.
February 20, 2013
MVIbp_SetModuleInterrupt (MVI46)
Syntax
int MVIbp_SetModuleInterrupt(MVIHANDLE handle);
Parameters
handle Handle returned by previous call to MVIbp_Open
Description
MVIbp_SetModuleInterrupt generates a Module Interrupt to the host Controller.
This function can only be used when the module is configured as a Class 4
module.
handle must be a valid handle returned from MVIbp_Open.
This function waits for the host Controller to acknowledge the interrupt, which
may take up to 2.5 seconds. The host Controller must be in RUN mode and must
contain a Module Interrupt function routine to process and acknowledge the
interrupt. The acknowledge from the Controller may either be Success or Failure,
depending on the interrupt routine.
Return Value
MVI_SUCCESS The module file data was read successfully.
MVI_ERR_NOACCESS handle does not have access
MVI_ERR_TIMEOUT The function timed out waiting for an acknowledge
MVI46_ERR_PROGMODE Controller not in RUN mode
MVI46_ERR_INVALIDCLASS The module is not Class 4
MVI46_ERR_SLOTDIS The module’s slot has been disabled by the Controller
MVI46_ERR_SERVFAIL The Controller acknowledged the interrupt with Failure
Example
MVIHANDLE Handle;
/* Generate a module interrupt and wait for ack */
if (MVI_SUCCESS == MVIbp_SetModuleInterrupt(Handle))
printf("Module Interrupt Successful\n");
else
printf("Module Interrupt Failed\n");