总结
映射连接到 IOBuffer 的内存区域。此调用的语义与 zx_vmar_map 类似，但不支持映射区域子集。
声明
#include <zircon/syscalls.h>
zx_status_t zx_vmar_map_iob(zx_handle_t handle,
zx_vm_option_t options,
size_t vmar_offset,
zx_handle_t iob_ep,
uint32_t region_index,
size_t region_len,
zx_vaddr_t* addr_out);
说明
将指定的 IOBuffer 区域映射到指定的虚拟内存地址区域。映射区域会保留对已映射区域的引用，这意味着关闭映射该区域的端点不会移除此函数添加的映射。
options 等效于 zx_vmar_map 的 options 参数
vmar_offset 等同于 zx_vmar_map 的 vmar_offset 参数。
ep 是包含要映射的区域的端点（如 zx_iob_create 中所创建）。
region_index 是要映射的内存区域的索引。
region_offset 等同于 zx_vmar_map 的 vmo_offset 参数。
region_len 等同于 zx_vmar_map 的 len 参数。它必须由非零值对齐且页面对齐
返回值
zx_vmar_map_iob() 会在成功时返回 ZX_OK 和映射的绝对基址（通过 addr_out）。基地址将与页面对齐，且为非零值。如果失败，则返回负数错误值。
错误
ZX_ERR_BAD_HANDLE handle 或 iob_ep 不是有效的句柄。
ZX_ERR_WRONG_TYPE handle 或 iob_ep 分别不是 VMAR 或 IOB 句柄。
ZX_ERR_BAD_STATE 句柄是指已销毁的 VMAR。
以下任意一项的 ZX_ERR_INVALID_ARGS：
- mapped_addr 或 options 都无效。
- 如果未指定 ZX_VM_SPECIFIC、ZX_VM_SPECIFIC_OVERWRITE 或 ZX_VM_OFFSET_IS_UPPER_LIMIT，vmar_offset 为非零值。
- 同时指定了 ZX_VM_SPECIFIC_OVERWRITE 和 ZX_VM_MAP_RANGE。
- ZX_VM_OFFSET_IS_UPPER_LIMIT 与 ZX_VM_SPECIFIC 或 ZX_VM_SPECIFIC_OVERWRITE 一起指定。
- vmar_offset 和 len 描述了由于超出区域边界而导致不满足的分配。
- vmar_offset 或 region_offset 未进行页面对齐。
- region_len 为 0 或未页面对齐。
ZX_ERR_ALREADY_EXISTS ZX_VM_SPECIFIC 已在未指定 ZX_VM_SPECIFIC_OVERWRITE 的情况下指定，并且请求的范围与另一个映射重叠。
ZX_ERR_NO_RESOURCES：如果在 VMAR 中找不到时间点以创建映射。
ZX_ERR_ACCESS_DENIED权限不足，无法创建所请求的映射。
ZX_ERR_NOT_SUPPORTED：如果区域可调整大小、可舍弃或由分页器支持，但未设置 ZX_VM_ALLOW_FAULTS。
ZX_ERR_BUFFER_TOO_SMALL：无法调整区域大小，且映射超出该区域的末尾，但 ZX_VM_ALLOW_FAULTS 未设置。
ZX_ERR_NO_MEMORY 由于内存不足而失败。
用户空间没有什么方法来处理此（不太可能）错误。在以后的 build 中，此错误不会再发生。
ZX_ERR_OUT_OF_RANGE（适用于以下任意一种情况）：
- region_offset + ROUNDUP(len, PAGE_SIZE) 溢出。
- region_index 对提供的 IOB 无效
备注
VMAR 操作
映射的区域通常支持 VMAR 操作，例如 zx_vmar_protect、zx_vmar_op_range、zx_vmar_destroy。区域的访问权限规则可以按照规则规范中所述修改或限制这些操作。