mmioSetBuffer - Parameters

hmmio (HMMIO) - input

The open file handle returned by mmioOpen.

pchBuffer (PCHAR) - input

A pointer to the caller-supplied buffer to use for buffered I/O. It can be NULL if the caller wants mmioSetBuffer to allocate the buffer, or wants buffered I/O to be disabled.

cBytes (LONG) - input

The size of the caller-supplied buffer, or (if pchBuffer is NULL) the size of the buffer that the caller wants mmioSetBuffer to allocate.

usFlags (USHORT) - input

Reserved for future use and must be set to zero.

rc (USHORT) - returns

Return codes indicating success or type of failure:

MMIO_SUCCESS

If the function succeeds, 0 is returned.
MMIOERR_INVALID_HANDLE
The handle passed was not correct.
MMIOERR_UNBUFFERED
Tried to disable a buffer already disabled.
MMIOERR_INVALID_BUFFER_LENGTH
The buffer length is invalid.
MMIOERR_CANNOTWRITE
The buffer could not be written to disk. It might be full.
MMIOERR_READ_FAILED
Set Buffer failed during a read operation.
MMIOERR_SEEK_FAILED
Set Buffer failed during a seek operation.
MMIOERR_WRITE_FAILED
Set Buffer failed during a write operation.
MMIOERR_OUTOFMEMORY
A buffer was expected but not allocated.

---

[Back: mmioSetBuffer Return Value - rc]
[Next: mmioSetBuffer - Remarks]