zx_vmo_get_size

摘要

讀取 VMO 物件目前的大小。

宣告

#include <zircon/syscalls.h>

zx_status_t zx_vmo_get_size(zx_handle_t handle, uint64_t* size);

說明

zx_vmo_get_size() 會傳回虛擬記憶體物件 (VMO) 目前的大小。建立 VMO 時指定的大小 (例如使用 zx_vmo_create())，而使用 zx_vmo_set_size() 調整 VMO 大小時，系統會將其進位至下一個系統頁面大小邊界。因此，zx_vmo_get_size() 傳回的值一律會以頁面對齊。

權限

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

傳回值

zx_vmo_get_size() 在成功時傳回 ZX_OK。如果失敗，系統會傳回負值的錯誤值。

錯誤

「ZX_ERR_BAD_HANDLE」的帳號代碼並非有效的帳號代碼。

ZX_ERR_WRONG_TYPE 帳號代碼並非 VMO 控制代碼。

ZX_ERR_INVALID_ARGS size 是無效指標或 NULL。

另請參閱

• zx_vmo_create()
• zx_vmo_create_child()
• zx_vmo_op_range()
• zx_vmo_read()
• zx_vmo_set_size()
• zx_vmo_write()

讀取 VMO 物件目前的大小。