mpiSynqNetEventNotifySet

Declaration

MPI_RESULT
   mpiSynqNetEventNotifySet(MPISynqNet                 synqNet,
                            const MPIEventMask         eventMask,
                            const MPIEventNotifyData   *eventNotifyData);

 

Required Header: stdmpi.h
Change History: Modified in 04.00.

Description

mpiSynqNetEventNotifySet requests host notification of the events that are generated by SynqNet and specified by eventMask, and also specified by the event notification structure (that specifies the event message controller addresses) to the location pointed to by eventNotifyData.

Use the event mask macros mpiEventMaskSYNQNET(...), mpiEventMaskSET(...), mpiEventMaskBitSET(...), mpiEventMaskCLEAR(...), etc. to create the eventMask.

synqNet A handle to a SynqNet object.
eventMask Pointer to an event mask, whose bits are defined by the MPIEventType enumerations.
*eventNotifyData Pointer to an event notification data structure that contains a list of controller addresses. The event data specified by the addresses is copied into the event message by the controller.
Return Values
MPIMessageOK
MPIMessageARG_INVALID

Sample Code

/* Request notification of all events from SynqNet */
mpiEventMaskCLEAR(eventMask);

returnValue =
    mpiSynqNetEventNotifyGet(synqNet,
                             &eventMask,
                             NULL);

mpiEventMaskSYNQNET(eventMask);
	
if (returnValue == MPIMessageOK) {
    returnValue =
        mpiSynqNetEventNotifySet(synqNet,
                                 eventMask,
                                 NULL);
}

See Also

MPIEventType | MPIEventNotifyData