mmioIniFileHandler - Parameters

pmminifileinfo (PMMINIFILEINFO) - input

A pointer to the MMINIFILEINFO structure that contains the FOURCC code, DLL name, and the name of the I/O procedure.

ulFlags (ULONG) - input

Specifies options for the operation. Contains one of the following flags:

MMIO_INSTALLPROC

Adds an I/O procedure to the end of the MMPMMMIO.INI file. If an existing entry in the table matches the new entry, the new entry replaces the existing entry. An entry match is determined by specifying 0 or more of the match flags. If none are specified, the default is to match on the FOURCC code.
MMIO_REMOVEPROC
Deletes a matching entry from the MMPMMMIO.INI file. An entry match is determined by specifying 0 or more of the match flags. If none are specified, the default is to match on the FOURCC code.
MMIO_FINDPROC
Finds a matching entry from the MMPMMMIO.INI file. This fills in the remainder of the MMINIFILEINFO structure passed in the pmminifileinfo parameter. An entry match is determined by specifying 0 or more of the match flags. If none are specified, the default is to match on the FOURCC.

Note: If MMIO_FINDFIRST is set, then MMIO_FINDPROC does not default to the FOURCC.

MMIO_MATCHFIRST
Finds the first entry in the MMPMMMIO.INI file if no match flags are specified. Otherwise, it finds the first entry that matches the contents of the fields specified by the match flags. In either case, the MMINIFILEINFO structure is returned.
MMIO_MATCHNEXT
If no match flags are specified, this finds the next entry in the MMPMMMIO.INI file following the entry (MMINIFILEINFO structure) passed in the pmminifileinfo parameter. If match flags are specified, this finds the next entry that matches the search criteria specified by the flags. In either case, the MMINIFILEINFO structure is returned.
MMIO_MATCHFOURCC
Use the FOURCC code (fccIOProc field of the MMINIFILEINFO structure) as a search criteria.
MMIO_MATCHDLL
Use the DLL Name (szDLLName field of the MMINIFILEINFO structure) as a search criteria.
MMIO_MATCHPROCEDURENAME
Use the case-sensitive procedure name (szProcName field of the MMINIFILEINFO structure) as a search criteria.
MMIO_FULLPATH
Use the drive or path given with the DLL name (szDLLName field of the MMINIFILEINFO structure), otherwise use only the base file name. This allows DLLs with the same base name to be loaded from different directories.
MMIO_EXTENDED_STRUCT
This flag must be set for release 1.1 and later releases. It indicates the expanded structure is being used.

rc (ULONG) - returns

Return codes indicating success or type of failure:

MMIO_SUCCESS

If the function succeeds, 0 is returned.
MMIO_ERROR
The function failed for a reason different from any of the following returns in this list.
MMIOERR_INVALID_PARAMETER
An invalid parameter was passed.
MMIOERR_INTERNAL_SYSTEM
An internal system error was found.
MMIOERR_NO_CORE
Unable to allocate enough memory for the MMPMMMIO.INI data.
MMIOERR_INI_OPEN
Unable to open the MMPMMMIO.INI file.
MMIOERR_INVALID_DLLNAME
Unable to validate the DLL name.
MMIOERR_INVALID_PROCEDURENAME
Unable to validate the procedure name.
MMIOERR_MATCH_NOT_FOUND
Unable to find the I/O procedure to satisfy the input criteria.

---

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