mmioCreateChunk - Parameters

hmmio (HMMIO) - input

The open file handle returned by mmioOpen.

pckinfo (PMMCKINFO) - input

A pointer to an MMCKINFO data structure that is to be filled in as follows:

ckid

Must be the chunk ID of the chunk to create. If usFlags includes MMIO_CREATERIFF or MMIO_CREATELIST, this field will be filled in by mmioCreateChunk.
ckSize
Must be the size of the data portion of the chunk, including the form type or list type (if any) but not including the 8-byte chunk header or the terminating null (if any). If this value is not correct when mmioAscend is called to mark the end of the chunk, then mmioAscend will seek back and correct the chunk size.
fccType
Must contain the form type or list type, respectively, if usFlags contains MMIO_CREATERIFF or MMIO_CREATELIST.
ulDataOffset
This field will be filled in on the return from mmioCreateChunk. It will contain the file offset of the beginning of the data portion of the chunk.
ulFlags
This field will be filled in on the return from this mmioCreateChunk. It will contain the MMIO_DIRTY flag to indicate this chunk was created with mmioCreateChunk.

usFlags (USHORT) - input

Contains none or one of the following flags:

MMIO_CREATERIFF

Create a chunk with an ID (ckid field) of RIFF and a form type in the fccType field.
MMIO_CREATELIST
Create a chunk with an ID (ckid field) of LIST and a list type in the fccType field.

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 valid.
MMIOERR_INVALID_PARAMETER
The parameter passed was not valid.
MMIOERR_CANNOTWRITE
The I/O buffer needs to be written to disk but disk space is lacking.

---

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