摘要
指定物件的對等點。
宣告
#include <zircon/syscalls.h>
zx_status_t zx_object_signal_peer(zx_handle_t handle,
uint32_t clear_mask,
uint32_t set_mask);
說明
zx_object_signal_peer() 會斷言並解壓縮可存取的使用者空間
在物件的對等點上傳送位元。物件對等點與
channel、socket、fifo 或 eventpair。
這 32 個信號大多保留給系統使用，並指派給
建立個別物件的函式，例如 ZX_CHANNEL_READABLE 或 ZX_TASK_TERMINATED。有
有 8 個信號位元可供使用者空間程序視需要使用：
ZX_USER_SIGNAL_0至 ZX_USER_SIGNAL_7。
Eventpair 物件也允許控制 ZX_EVENTPAIR_SIGNALED 位元。
系統會先使用 clear_mask 清除任何指定的位元，隨後 set_mask 用來設定任何指定的位元。
權限
handle 必須包含 ZX_RIGHT_SIGNAL_PEER。
傳回值
zx_object_signal_peer() 會在成功時傳回 ZX_OK。如果發生以下情況：
失敗時，會傳回負的錯誤值。
錯誤
ZX_ERR_BAD_HANDLE 帳號代碼不是有效的帳號代碼。
ZX_ERR_ACCESS_DENIED 帳號代碼缺少正確的 ZX_RIGHT_SIGNAL_PEER。
ZX_ERR_INVALID_ARGS clear_mask 或 set_mask 包含系統禁止的位元。
ZX_ERR_NOT_SUPPORTED 用於沒有對等點的物件。
ZX_ERR_PEER_CLOSED 對具有封閉對等互連的物件呼叫。