摘要
發出物件的對等信號。
宣告
#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
在具有封閉式對等點的物件上呼叫。