zx_stream_create

摘要

透過 VMO 建立串流。

宣告

#include <zircon/syscalls.h>

zx_status_t zx_stream_create(uint32_t options,
                             zx_handle_t vmo,
                             zx_off_t seek,
                             zx_handle_t* out_stream);

說明

zx_stream_create() 會建立串流，讀取及寫入基礎 VMO 中的資料。

流量的尋軌偏移量會初始化為 seek。

選項

ZX_STREAM_MODE_READ這個訊息串將用於讀取。如果提供了 vmo 缺少 ZX_RIGHT_READ，這個函式會傳回 ZX_ERR_ACCESS_DENIED。否則，ZX_RIGHT_READ 會在建立的串流物件上加入權限。

ZX_STREAM_MODE_WRITE系統會使用串流進行寫入。如果提供了 vmo 缺少 ZX_RIGHT_WRITE，這個函式會傳回 ZX_ERR_ACCESS_DENIED。否則，ZX_RIGHT_WRITE 會在建立的串流物件中加入權限。

ZX_STREAM_MODE_APPEND 系統會以附加模式建立串流。串流 附加模式會以不可分割的形式，為內容設定串流的跳轉偏移 串流大小 (在寫入資料之前)zx_stream_writev()。

權限

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

傳回值

zx_stream_create() 會在成功時傳回 ZX_OK。如果發生以下情況： 失敗時，會傳回下列其中一個值。

錯誤

「ZX_ERR_BAD_HANDLE」vmo 不是有效的帳號代碼。

ZX_ERR_WRONG_TYPE vmo 是連續的實體或非 VMO 句柄。

ZX_ERR_ACCESS_DENIED vmo 沒有所需權限，無法使用指定選項。

ZX_ERR_INVALID_ARGS out_stream 是無效的指標或 NULL，out_stream 將不支援的位元設為 1。

ZX_ERR_NO_MEMORY 因記憶體不足而失敗。

另請參閱