zx_vmar_銷毀

摘要

刪除虛擬記憶體位址區域。

宣告

#include <zircon/syscalls.h>

zx_status_t zx_vmar_destroy(zx_handle_t handle);

說明

zx_vmar_destroy() 會取消對應指定區域內的所有對應,並刪除該地區的所有子區域。請注意,這項作業在邏輯上是遞迴。

這項作業不會關閉帳號代碼。對這個 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」的帳號代碼並非有效的帳號代碼。

ZX_ERR_WRONG_TYPE 帳號代碼並非 VMAR 帳號代碼。

ZX_ERR_BAD_STATE這個區域已刪除。

ZX_ERR_NOT_SUPPORTED 控制代碼是根 VMAR。

附註

另請參閱