zx_event_create

英文原文快照

名称

event_create —— 创建event对象

概要

  1. #include <zircon/syscalls.h>
  3. zx_status_t zx_event_create(uint32_t options, zx_handle_t* out);

描述

event_create() 创建一个event对象，该对象是可通知的。也就是说，可以使用object_signal() 来操纵其ZX_USER_SIGNAL_n（其中n是0到7）信号。

新创建的句柄将具有ZX_RIGHT_TRANSFER，ZX_RIGHT_DUPLICATE，ZX_RIGHT_READ，ZX_RIGHT_WRITE和ZX_RIGHT_SIGNAL权限。

权限

TODO(ZX-2399)

返回值

event_create() 成功则返回ZX_OK和（通过out）返回有效的event句柄。失败时，则返回错误码。

错误码

ZX_ERR_INVALID_ARGS： out是无效指针，或options非零。

ZX_ERR_NO_MEMORY：由于内存不足导致的失败。而用户空间无法处理这个（不太可能发生的）错误。在将来的构建版本中，将不再出现此错误。

另见

eventpair_create，handle_close, handle_duplicate，object_wait_one，object_wait_many，handle_replace，object_signal。