zx_iob_create_shared_region

摘要

建立可與多個 IOBuffer 物件搭配使用的共用區域。

宣告

#include <zircon/syscalls-next.h>

zx_status_t zx_iob_create_shared_region(uint64_t options,
                                        uint64_t size,
                                        zx_handle_t* out);

說明

建立可與多個 IOBuffer 物件搭配使用的共用區域。

options 必須為零。size 必須是頁面大小的倍數。

傳回值

如果成功，系統會傳回 ZX_OK，並在 out 中填入新的句柄。

錯誤

ZX_ERR_ACCESS_DENIED 程序沒有建立共用 IOBuffer 區域的權限。

ZX_ERR_INVALID_ARGS options 非零值 (目前不支援非預設選項)，或是 size 為零或不是頁面大小的倍數。

ZX_ERR_NO_MEMORY 因記憶體不足而無法分配共用區域，導致失敗。