zx_event_create

NAME

event_create - create an event

SYNOPSIS

#include <zircon/syscalls.h>

zx_status_t zx_event_create(uint32_t options, zx_handle_t* out);

DESCRIPTION

event_create() creates an event, which is an object that is signalable. That is, its ZX_USER_SIGNAL_n (where n is 0 through 7) signals can be manipulated using object_signal().

The newly-created handle will have the ZX_RIGHT_TRANSFER, ZX_RIGHT_DUPLICATE, ZX_RIGHT_READ, ZX_RIGHT_WRITE, and ZX_RIGHT_SIGNAL rights.

RETURN VALUE

event_create() returns ZX_OK and a valid event handle (via out) on success. On failure, an error value is returned.

ERRORS

ZX_ERR_INVALID_ARGS out is an invalid pointer, or options is nonzero.

ZX_ERR_NO_MEMORY Temporary failure due to lack of memory.

SEE ALSO

eventpair_create, handle_close, handle_duplicate, object_wait_one, object_wait_many, handle_replace, object_signal.