摘要
从 VMO 读取字节。
声明
#include <zircon/syscalls.h>
zx_status_t zx_vmo_read(zx_handle_t handle,
void* buffer,
uint64_t offset,
size_t buffer_size);
说明
zx_vmo_read() 尝试从 偏移量处的虚拟内存对象 (VMO) 读取正好 buffer_size 个字节。
指向用户缓冲区的 buffer 指针，用于读取字节。
尝试读取的字节数（buffer_size）。缓冲区 (buffer) 应足够大，至少能容纳这么多字节。
权限
句柄必须是 ZX_OBJ_TYPE_VMO 类型，并且具有 ZX_RIGHT_READ。
返回值
如果 zx_vmo_read() 成功，则返回 ZX_OK，并且已将正好 buffer_size 个字节写入 buffer。
如果失败，则返回负错误值，并且写入 buffer 的字节数未定义。
错误
ZX_ERR_BAD_HANDLE 句柄不是有效的句柄。
ZX_ERR_WRONG_TYPE handle 不是 VMO handle。
ZX_ERR_ACCESS_DENIED 句柄不具有 ZX_RIGHT_READ 权限，或者 [buffer, buffer + buffer_size) 不可写入。
ZX_ERR_NOT_FOUND buffer 地址未映射到地址空间中的地址。
ZX_ERR_OUT_OF_RANGE offset + buffer_size 大于 VMO 的大小。
ZX_ERR_BAD_STATE VMO 已标记为未缓存，无法直接读取；或者 VMO 由分页器提供支持，但分页器或 VMO 处于不良状态，导致无法填充所请求的页面。
ZX_ERR_IO VMO 由分页器提供支持，但分页器在读取所请求的页面时遇到 I/O 错误。
ZX_ERR_IO_DATA_INTEGRITY VMO 由分页器提供支持，并且分页器读取的内容已损坏。