zx_vmar_destroy

摘要

销毁虚拟内存地址区域。

声明

#include <zircon/syscalls.h>

zx_status_t zx_vmar_destroy(zx_handle_t handle);

说明

zx_vmar_destroy():用于取消映射指定区域内的所有映射并销毁 该区域的所有次级区域。请注意,此操作在逻辑上是递归的。

此操作不会关闭 handle。此资源的所有待处理标识名 VMAR 将仍然有效,但对其执行的所有 VMAR 操作都将失败。

无法销毁通过 zx_process_create() 获取的根 VMAR。

权限

TODO(https://fxbug.dev/42107318)

返回值

如果成功,zx_vmar_destroy() 会返回 ZX_OK

错误

ZX_ERR_ACCESS_DENIED 句柄没有 ZX_RIGHT_OP_CHILDREN

ZX_ERR_BAD_HANDLE handle 不是有效的句柄。

ZX_ERR_WRONG_TYPE handle 不是 VMAR 句柄。

ZX_ERR_BAD_STATE 此区域已销毁。

ZX_ERR_NOT_SUPPORTED handle 是一个根 VMAR。

备注

另请参阅