zx_iob_create_shared_region

Summary

Creates a shared region that can be used with multiple IOBuffer objects.

Declaration

#include <zircon/syscalls-next.h> zx_status_t zx_iob_create_shared_region(uint64_t options,  uint64_t size,  zx_handle_t* out); 

Description

Creates a shared region that can be used with multiple IOBuffer objects.

options must be zero. size must be a multiple of the page size.

Return value

On success, ZX_OK is returned and out will be populated with a new handle.

Errors

ZX_ERR_ACCESS_DENIED The proess does not have permissions to create shared IOBuffer regions.

ZX_ERR_INVALID_ARGS options was nonzero (there are no non-default options supported at this time), or size was zero or not a multiple of the page size.

ZX_ERR_NO_MEMORY Failure due to lack of memory to allocate the shared region.