meiSynqNetEventNotifySet

Declaration

	long meiSynqNetEventNotifySet(MEISynqNet synqNet, MPIEventMask eventMask, void *external);
	Required Header: stdmei.h

Description

meiSynqNetEventNotifySet requests host notification of the event(s) that are generated by SynqNet 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 meiEventMaskSYNQNET(...), 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 either eventMask is NULL or external is NULL (not both), then the event notification data will not be copied to the NULL 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).

synqNet	a handle to a SynqNet 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