mpiControlNotifyDelete

Declaration

MPI_RESULT
   mpiControlNotifyDelete(MPIControl control,
                          MPINotify  notify);

 

Required Header: stdmpi.h

Change History: Added in 04.00.

Description

mpiControlNotifyDelete removes notify from the list of Notify objects of the controller the Notify object is associated with, then deletes notify.

control The control object from which the notify object is to be removed.
notify The Notify object that is to be removed to the list of Notify objects the Service object sends events to.

Sample Code

    /* Create a notify object to store events */
    returnValue =
       mpiControlNotifyCreate(¬ify, control);
    msgCHECK(returnValue);

    /* Start a motion */
    returnValue =
       mpiMotionStart(motion, MPIMotionTypeS_CURVE, &motionParams);
    msgCHECK(returnValue);


    /* Wait for a motion done event from the motion object */
    returnValue =
       mpiNotifyEventWaitSpecific(notify, NULL, motion, MPIEventTypeMOTION_DONE, MPIWaitFOREVER);
    msgCHECK(returnValue);

    /* We're done with the notify object.  We can delete it now. */
    returnValue =
       mpiControlNotifyDelete(notify);
    msgCHECK(returnValue);

See Also

mpiControlNotifyCreate