摘要
创建活动。
声明
#include <zircon/syscalls.h>
zx_status_t zx_event_create(uint32_t options, zx_handle_t* out);
说明
zx_event_create()
会创建一个事件,即一个可发送信号的对象。这样
是,其 ZX_USER_SIGNAL_n
(其中 n 为 0 到 7)信号可以是
使用 zx_object_signal()
处理。
新创建的标识名将具有基本标识名,
权利和 ZX_RIGHT_SIGNAL
。
权限
调用方作业政策必须允许 ZX_POL_NEW_EVENT
。
返回值
如果操作成功,zx_event_create()
会返回 ZX_OK
和有效的事件句柄(通过 out)。
如果失败,则会返回错误值。
错误
ZX_ERR_INVALID_ARGS
out 是无效指针,或 options 为非零值。
ZX_ERR_NO_MEMORY
因内存不足而失败。
用户空间没有好办法处理这种(不太可能)错误。
在将来的版本中,此错误不会再发生。
另请参阅
zx_eventpair_create()
zx_handle_close()
zx_handle_duplicate()
zx_handle_replace()
zx_object_signal()
zx_object_wait_async()
zx_object_wait_many()
zx_object_wait_one()