zx_stream_readv_at

摘要

从指定偏移量处读取数据。

声明

#include <zircon/syscalls.h>

zx_status_t zx_stream_readv_at(zx_handle_t handle,
                               uint32_t options,
                               zx_off_t offset,
                               zx_iovec_t* vectors,
                               size_t num_vectors,
                               size_t* actual);

说明

zx_stream_readv_at() 尝试从数据流中读取字节，从 给定 offset 传递到由 vectors 和 num_vectors 指定的缓冲区。如果 则通过 actual 返回实际读取的字节数。

如果指定的偏移量超出数据流的结束位置，zx_stream_readv_at() 将成功读取零个字节。

如果传入 NULL actual，则将忽略它。

不将流的跳转偏移量提前。

如果矢量的内容在此操作期间发生更改（如果任何缓冲区） 重叠，或者如果任何缓冲区与矢量重叠，则该行为未指定。

options 留待将来使用，并且必须为 0。

权限

handle 的类型必须为 ZX_OBJ_TYPE_STREAM 且包含 ZX_RIGHT_READ。

返回值

zx_stream_readv_at() 会在成功时返回 ZX_OK，并写入 actual（如果为非 NULL）读取的确切字节数。

错误

ZX_ERR_BAD_HANDLE handle 不是有效的句柄。

ZX_ERR_WRONG_TYPE handle 不是流句柄。

ZX_ERR_ACCESS_DENIED 句柄没有 ZX_RIGHT_READ 权限。

ZX_ERR_INVALID_ARGS 矢量是无效的 zx_iovec_t，或 options 是 非零值。

ZX_ERR_NOT_FOUND：矢量地址或 矢量不会映射到地址空间中的地址。

ZX_ERR_BAD_STATE：表示无法读取底层数据源。

另请参阅