摘要
建立活動。
宣告
#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
和有效的事件控制代碼 (透過輸出)。
失敗時會傳回錯誤值。
錯誤
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()