Contains one or more of the following flags:
Note: The MMIO_READ, MMIO_WRITE, and MMIO_READWRITE flags are mutually
exclusive.
MMIO_READ
Opens the file for reading only. This
is the default behavior if MMIO_WRITE and MMIO_READWRITE are not specified.
However, the flag is not automatically set in the default case.
MMIO_WRITE
Opens the file for writing. You should not read
from a file opened in this way.
MMIO_READWRITE
Opens
the file for both reading and writing.
Note: To save a wave file, you must open the file with the MMIO_READWRITE
flag. After the data is written, the I/O procedure will need to descend
back into the wave chunk-a process that requires read support.
MMIO_BUFSHARED
Requests that if MMIO services allocates the I/O
buffer, it does so from shared memory.
MMIO_VERTBAR
Requests that the vertical bar symbol (|) rather
than the plus sign (+) be used as a file separator.
MMIO_EXCLUSIVE
Opens the file with exclusive mode, denying other
processes both read and write access to the file. mmioOpen fails if the
file has been opened in any other mode for read or write access, even by
the current process.
MMIO_DENYWRITE
Opens
the file and denies other processes write access. mmioOpen fails if the
file has been opened in compatibility or for write access by any other process.
MMIO_DENYREAD
Opens the
file and denies other processes read access. mmioOpen fails if the file
has been opened in compatibility or for read access by any other process.
MMIO_DENYNONE
Opens the
file and denies other processes read access. mmioOpen fails if the file
has been opened in compatibility or for read access by any other process.
This is the default if no share mode flags are defined.
MMIO_CREATE
Directs mmioOpen to create a new file. If the
file already exists, it is truncated to 0 length. For a memory file, MMIO_CREATE
indicates the end of the file is initially at the start of the buffer.
MMIO_DELETE
Directs mmioOpen to delete the file. The pszFileName
parameter should not be NULL. The return value will be TRUE (sent to
hmmio) if the file was deleted successfully, FALSE otherwise. Do
not call mmioClose if MMIO_DELETE has
been specified. All other flags are ignored if MMIO_DELETE is specified.
MMIO_ALLOCBUF
Directs mmioOpen
to allocate an I/O buffer. If the cchBuffer field of MMIOINFO
is 0, then a default buffer size (specified by the constant MMIO_DEFAULTBUFFER)
is used. If the caller provides an I/O buffer, then MMIO_ALLOCBUF should
not be specified.
MMIO_APPEND
Directs
mmioOpen to allow appending to the end of the file. This will cause the
logical file pointer to be positioned at the end of file when the open process
completes. The open fails if both MMIO_CREATE and MMIO_APPEND are set.
In the case of a BND element, this flag allows the element to expand past
its existing fixed boundary by deleting the existing element and rewriting
it at the end of a compound-file resource group (CGRP).
MMIO_NOIDENTIFY
Directs mmioOpen to directly open the file without
attempting to automatically identify the file. An automatic identify is
the default for this function.
[Back]
[Next]