message_pipe_create - create a message pipe
#include <magenta/syscalls.h>
mx_status_t mx_message_pipe_create(mx_handle_t handles[2], uint32_t flags);
message_pipe_create() creates a message pipe, a bi-directional datagram-style message transport capable of sending raw data bytes as well as handles from one side to the other.
Two handles are returned on success, providing access to both sides of the message pipe. Messages written to one handle may be read from the opposite.
The handles will have MX_RIGHT_TRANSFER (allowing them to be sent to another process via message pipe write), MX_RIGHT_WRITE (allowing messages to be written to them), and MX_RIGHT_READ (allowing messages to be read from them).
The flags can be either 0 or MX_FLAG_REPLY_PIPE. A reply pipe behaves like a regular message pipe except for mx_message_write() which must include itself as the last handle being transfered.
When flags is MX_FLAG_REPLY_PIPE, only handles[1] is a reply pipe. handles[0] is a regular pipe.
message_pipe_create() returns NO_ERROR on success. In the event of failure, a negative error value is returned.
ERR_INVALID_ARGS handles is an invalid pointer or NULL.
ERR_NO_MEMORY (Temporary) Failure due to lack of memory.
handle_close, handle_duplicate, handle_wait_one, handle_wait_many, message_read, message_write.