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_OUT_OF_RANGE 要求的大小過大。

ZX_ERR_NO_MEMORY 由於記憶體不足，無法配置共用區域，因此失敗。