总结
向对象的对等方发出信号。
声明
#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
对具有关闭对等项的对象调用。