event_create - create an event
#include <magenta/syscalls.h>
mx_status_t mx_event_create(uint32_t options, mx_handle_t* out);
event_create() creates an event, which is an object that is signalable. That is, its MX_USER_SIGNAL_n (where n is 0 through 7) signals can be manipulated using object_signal().
The newly-created handle will have the MX_RIGHT_TRANSER, MX_RIGHT_DUPLICATE, MX_RIGHT_READ, and MX_RIGHT_WRITE rights.
event_create() returns NO_ERROR and a valid event handle (via out) on success. On failure, an error value is returned.
ERR_INVALID_ARGS out is an invalid pointer, or options is nonzero.
ERR_NO_MEMORY Temporary failure due to lack of memory.
eventpair_create, handle_close, handle_duplicate, object_wait_one, object_wait_many, handle_replace, object_signal.