Opens an existing FIFO or creates a new one.
#include <nks/fsio.h>
int NXFifoOpen (
NXPathCtx_t pathCtx,
const void *pathname,
NXMode_t mode,
size_t fifoSize,
NXHandle_t *fifoHandle);
(IN) Specifies a path context. On NetWare, this parameter is ignored so set it to 0.
(IN) Points to a null-terminated Unicode or ASCII string, which specifies the name of the FIFO to open (or create).
(IN) Specifies how the FIFO is used (see NKS Open Modes).
(IN) Specifies the maximum amount of data that can be held in the FIFO. If zero is passed, a buffer of NX_FIFO_BUFSIZE is used.
(OUT) Points to the handle of the opened or created FIFO.
If successful, returns 0 and a FIFO handle in the fifoHandle parameter. Otherwise, returns one of the following error codes and -1 in the fifoHandle parameter.
For more information about FIFOs, see FIFOs.
Each time a FIFO is opened, the mode flags determine whether the open is for reading or writing, never both. By default, FIFOs are opened in a blocking state. To set the FIFO in a nonblocking state, OR the nonblocking flag to the read or write flag.