meiSynqNetEventNotifyGet

Declaration

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

Description

meiSynqNetEventNotifyGet reads the event mask (that specifies the event types for which host notification has been requested) to the location pointed to by eventMask, and also writes it into the implementation specific location pointed to by external. (if external is not NULL).

Use the event mask macros mpiEventMaskGET(...), mpiEventMaskBitGET(...), etc. to decode 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