Discards event occurrences for specified event types and mechanisms in a session.
ViStatus viDiscardEvents(ViSession vi, ViEventType eventType, ViUInt16 mechanism)
viDiscardEvents&(ByVal vi&, ByVal eventType&, ByVal mechanism%)
All I/O session types
Name | Direction | Description |
---|---|---|
vi |
IN |
Unique logical identifier to a session. |
eventType |
IN |
Logical event identifier. |
mechanism |
IN |
Specifies the mechanisms for which the events are to be discarded. The VI_QUEUE (1) value is specified for the queuing mechanism and the VI_SUSPEND_HNDLR (4) value is specified for the pending events in the callback mechanism. It is possible to specify both mechanisms simultaneously by specifying VI_ALL_MECH (FFFFh). |
Completion Codes | Description |
---|---|
VI_SUCCESS |
Event queue flushed successfully. |
VI_SUCCESS_QUEUE_EMPTY |
Operation completed successfully, but queue was already empty. |
Error Codes | Description |
---|---|
VI_ERROR_INV_OBJECT |
The given session reference is invalid. |
VI_ERROR_INV_EVENT |
Specified eventType is not supported by the resource. |
VI_ERROR_INV_MECH |
Invalid mechanism specified. |
The viDiscardEvents() operation discards all pending occurrences of the specified event types and mechanisms from the specified session. Specifying VI_ALL_ENABLED_EVENTS for the eventType parameter discards events of every type that is enabled for the given session. The information about all the event occurrences which have not yet been handled is discarded. This operation is useful to remove event occurrences that an application no longer needs. The discarded event occurrences are not available to a session at a later time. This operation does not apply to event contexts that have already been delivered to the application.
Related Topics