ZX_event_create

摘要

建立活動。

宣告

#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 因記憶體不足而失敗。使用者空間無法以任何方式處理這個錯誤 (極可能) 錯誤。日後的建構作業不會再發生這個錯誤。

另請參閱