zx_object_signal

摘要

為物件發出信號。

宣告

#include <zircon/syscalls.h>

zx_status_t zx_object_signal(zx_handle_t handle,
                             uint32_t clear_mask,
                             uint32_t set_mask);

說明

zx_object_signal() 會斷言並解除使用者空間可存取的信號 不會產生太多資料

這 32 個信號大多保留給系統使用，並指派給 建立個別物件的函式，例如 ZX_CHANNEL_READABLE 或 ZX_TASK_TERMINATED。有 有 8 個信號位元可供使用者空間程序視需要使用： ZX_USER_SIGNAL_0至 ZX_USER_SIGNAL_7。

Event 物件也允許控制 ZX_EVENT_SIGNALED 位元。

Eventpair 物件也允許控制 ZX_EVENTPAIR_SIGNALED 位元。

系統會先使用 clear_mask 清除任何指定的位元，隨後 set_mask 用來設定任何指定的位元。

權限

handle 必須包含 ZX_RIGHT_SIGNAL。

傳回值

zx_object_signal() 會在成功時傳回 ZX_OK。故障時， 會傳回負錯誤值。

錯誤

ZX_ERR_BAD_HANDLE 帳號代碼不是有效的帳號代碼。

ZX_ERR_ACCESS_DENIED 帳號代碼缺少正確的 ZX_RIGHT_SIGNAL。

ZX_ERR_INVALID_ARGS clear_mask 或 set_mask 包含系統禁止的位元。

另請參閱