zxvmo_create

摘要

创建虚拟机对象。

声明

#include <zircon/syscalls.h>

zx_status_t zx_vmo_create(uint64_t size, uint32_t options, zx_handle_t* out);

说明

zx_vmo_create() 会创建一个新的零填充虚拟内存 对象 (VMO)，它表示一个由 0 到 100 之间的容器 size（字节）由操作系统管理的内存。

VMO 的大小将四舍五入到下一个系统页面大小边界， 由zx_system_get_page_size()报告。使用 zx_vmo_get_size() 执行以下操作： 返回 VMO 的当前大小。

VMO 的内容大小将初始化为给定（未舍入）的大小。 结合使用 zx_object_get_property() 和 ZX_PROP_VMO_CONTENT_SIZE 来读取 VMO 的内容大小将 zx_object_set_property() 与以下账号搭配使用 ZX_PROP_VMO_CONTENT_SIZE，用于设置不使用 调整 VMO 的大小

成功后会返回一个句柄，表示具有所请求 。

默认情况下，标识名将设置以下权限：

  • ZX_RIGHT_DUPLICATE - 标识名可能重复。

  • ZX_RIGHT_TRANSFER - 标识名可能会转移到其他进程。

  • ZX_RIGHT_READ - 可以读取或映射到读取权限。

  • ZX_RIGHT_WRITE - 可以写入到或利用写入权限进行映射。

  • ZX_RIGHT_MAP - 可以映射。

  • ZX_RIGHT_GET_PROPERTY - 可以使用 zx_object_get_property() 获取其属性。

  • ZX_RIGHT_SET_PROPERTY - 可以使用 zx_object_set_property() 设置其属性。

  • ZX_RIGHT_RESIZE - 可以调整大小。仅在指定了 ZX_VMO_RESIZABLE 选项时设置。

options 字段可以为 0 或以下两者的组合：

  • ZX_VMO_RESIZABLE，用于创建一个可以更改大小的 VMO。不可调整大小的 VMO 的子项可以 调整大小。

  • ZX_VMO_DISCARDABLE，用于创建一个 VMO，以便内核从内存中舍弃页面 压力。将 zx_vmo_op_range() 与 ZX_VMO_OP_LOCK 搭配使用，以锁定可舍弃的 VMO 使用，并在完成 ZX_VMO_OP_UNLOCK 后再将其解锁，这样它们就符合回收条件 由内核执行新创建的可舍弃 VMO 最初会处于解锁状态。

  • ZX_VMO_UNBOUNDED，用于创建一个初始化为可能的最大大小的 VMO。不能是 与 ZX_VMO_RESIZABLE 结合使用。Size 参数仅设置数据流大小。

ZX_VMO_ZERO_CHILDREN 信号在新创建的 VMO 上处于有效状态。它会变为 每当创建 VMO 的子项时，它都会处于非活跃状态；当 VMO 的子项被创建时，状态会再次变为活跃状态 所有子对象均已被销毁，且这些子元素未映射到地址 空格。

权限

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

返回值

如果成功，zx_vmo_create() 会返回 ZX_OK。在活动中 则会返回负的错误值。

错误

ZX_ERR_INVALID_ARGS out 是无效的指针或 NULL，options 包含不受支持的值 标志组合。

ZX_ERR_NO_MEMORY 因内存不足而失败。 用户空间没有好办法处理这种（不太可能）错误。 在将来的版本中，此错误不会再发生。

ZX_ERR_OUT_OF_RANGE请求的内容过大。

另请参阅