zx_vmo_write

摘要

將位元組寫入 VMO。

宣告

#include <zircon/syscalls.h>

zx_status_t zx_vmo_write(zx_handle_t handle,
                         const void* buffer,
                         uint64_t offset,
                         size_t buffer_size);

說明

zx_vmo_write() 會嘗試將 buffer_size 位元組寫入虛擬記憶體 物件 (VMO) 位置。

buffer 指標指向要寫入位元組的使用者緩衝區。

buffer_size 要寫入的位元組數量。

權限

handle 必須是 ZX_OBJ_TYPE_VMO 類型，且包含 ZX_RIGHT_WRITE。

傳回值

zx_vmo_write() 會在成功時傳回 ZX_OK，而剛好 buffer_size 個位元組 來自 buffer。 失敗時，系統會傳回負錯誤值，以及 從 buffer 寫入的 個位元組未定義。

錯誤

ZX_ERR_BAD_HANDLE 帳號代碼不是有效的帳號代碼。

ZX_ERR_WRONG_TYPE 帳號代碼不是 VMO 控制代碼。

ZX_ERR_ACCESS_DENIED 帳號代碼沒有 ZX_RIGHT_WRITE 的右側 或 [buffer、buffer + buffer_size) 支付 難以閱讀。

ZX_ERR_INVALID_ARGS buffer 為無效的指標或 NULL。

ZX_ERR_NOT_FOUND buffer 位址未對應到位址空間中的位址。

ZX_ERR_NO_MEMORY 未分配系統記憶體才能完成寫入。

ZX_ERR_OUT_OF_RANGE offset + buffer_size 大於 擔任 VMO

ZX_ERR_BAD_STATE VMO 已標示為未快取，因此無法直接寫入。

另請參閱