zxport_create

总结

创建 IO 端口。

声明

#include <zircon/syscalls.h>

zx_status_t zx_port_create(uint32_t options, zx_handle_t* out);

说明

zx_port_create() 会创建一个端口：一个可等待对象，可用于读取按内核或用户模式排队的数据包。

如果您需要将此端口绑定到中断，请将 ZX_PORT_BIND_TO_INTERRUPT 传递给 options，否则应为 0。

如果端口绑定到中断，中断数据包会通过端口上的专用队列传送，并且优先级高于其他非中断数据包。

返回的句柄将包括：

  • ZX_RIGHT_TRANSFER：允许通过 zx_channel_write() 将它们发送到其他进程。
  • ZX_RIGHT_WRITE：允许将数据包加入队列。
  • ZX_RIGHT_READ：允许读取数据包。
  • ZX_RIGHT_DUPLICATE：允许对其进行复制。

权限

调用方作业政策必须允许 ZX_POL_NEW_PORT。

返回值

如果成功，zx_port_create() 会通过 out 返回 ZX_OK 和有效的 IO 端口句柄。如果失败，则返回错误值。

错误

ZX_ERR_INVALID_ARGS 选项包含无效值，或者 out 是无效指针或 NULL。

ZX_ERR_NO_MEMORY 由于内存不足而失败。 用户空间没有什么方法来处理此（不太可能）错误。在以后的 build 中，此错误不会再发生。

另请参阅