dat_evd_clear_unwaitable

- transition the Event Dispatcher into a waitable state

Synopsis

cc [ flag… ] file… -ldat [ library… ] 
#include <dat/udat.h>

DAT_RETURN
    dat_evd_clear_unwaitable(
    IN    DAT_EVD_HANDLE    evd_handle
    )

Parameters

evd_handle

Handle for an instance of Event Dispatcher.

Description

The dat_evd_clear_unwaitable() transitions the Event Dispatcher into a waitable state. In this state, calls to dat_evd_wait(3DAT) are permitted on the EVD. The actual state of the Event Dispatcher is accessible through dat_evd_query(3DAT) and is DAT_EVD_WAITABLE after the return of this operation.

This call does not affect a CNO associated with this EVD at all. Events arriving on the EVD after it is set waitable still trigger the CNO (if appropriate), and can be retrieved with dat_evd_dequeue(3DAT).

Return Values

DAT_SUCCESS

The operation was successful.

DAT_INVALID_HANDLE

The evd_handle parameter is invalid.

Attributes

See attributes(5) for descriptions of the following attributes:

See Also

dat_evd_dequeue(3DAT), dat_evd_query(3DAT), dat_evd_set_unwaitable(3DAT), dat_evd_wait(3DAT), libdat(3LIB), attributes(5)