meiSqNodeEventNotifySet

Declaration

	long meiSqNodeEventNotifySet(MEISqNode node, MPIEventMask eventMask, void *external);
	Required Header: stdmei.h

Description

meiSqNodeEventNotifySet requests host notification of the event(s) that are generated by SqNode and specified by eventMask, and also specified by the implementation specific location pointed to by external (if external is not NULL).

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

The event notification data in external is in addition to the event notification data in eventMask. If external is NULL, the event notification data will not be copied to the external pointer.

Remarks

external either points to a structure of type MEIEventNotifyData{} or is NULL.

The MEIEventNotifyData structure is an array of controller addresses, whose contents are placed into the MEIEventStatusInfo structure (of all events generated by this object).

node	a handle to a SynqNet node object
eventMask	pointer to an event mask, whose bits are defined by the MPI/MEIEventType enumerations.
*external	pointer to external

Return Values
MPIMessageOK
MPIMessageARG_INVALID