mpiRecorderEventNotifyGet

Declaration

long mpiRecorderEventNotifyGet(MPIRecorder  recorder,
                               MPIEventMask *eventMask,
                               void         *external)

Description

mpiRecorderEventNotifyGet writes the event mask into the structure pointed to by eventMask, and also writes it into the implementation-specific structure pointed to by external (if external is not NULL). (The event mask specifies the event type(s) generated by a Recorder (recorder), for which host notification has been requested.)

The event mask information in external is in addition to the event mask information in eventMask, i.e, the mask information in eventMask and in external is not the same mask information. Note that eventMask or external can be NULL (but not both NULL).

If recorder is set to record continuously in mpiRecorderStart, and bufferWrap is set to TRUE in MPIRecorderConfig, only MPIEventTypeRECORDER_FULL will be generated. Recorder events MPIEventTypeRECORDER_HIGH and MPIEventTypeRECORDER_DONE will not be generated.

Remarks

external either points to a structure of type MEIEventNotifyData{} or is NULL. An MEIEventNotifyData{} structure is an array of firmware addresses. The contents of these firmware addresses are placed into the MEIEventStatusInfo{} structure (which contains all events generated by this Recorder object).

See Also

MEIEventNotifyData | MEIEventStatusInfo | mpiRecorderEventNotifySet