port_create - create an IO port
#include <magenta/syscalls.h>
mx_status_t mx_port_create(uint32_t options, mx_handle_t* out);
port_create() creates an IO port; a waitable object that can be used to read IO packets queued by kernel or by user-mode.
The returned handle will have MX_RIGHT_TRANSFER (allowing them to be sent to another process via channel write), MX_RIGHT_WRITE (allowing packets to be queued), MX_RIGHT_READ (allowing packets to be read) and MX_RIGHT_DUPLICATE (allowing them to be duplicated).
options must be zero.
port_create() returns NO_ERROR and a valid IO port handle via out on success. In the event of failure, an error value is returned.
ERR_INVALID_ARGS options has an invalid value.
ERR_INVALID_ARGS out is an invalid pointer or NULL.
ERR_NO_MEMORY (Temporary) Failure due to lack of memory.
port_queue, port_wait, port_bind, handle_close, handle_duplicate, handle_replace.