pCODECIniFileInfo (PCODECINIFILEINFO) - in/out

A pointer to the CODECINIFILEINFO structure that contains the file format FOURCC, compression type, compression subtype, CODEC DLL name, entry procedure name, and other CODEC Procedure information.

ulFlags (ULONG) - input

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

MMIO_INSTALLPROC

Adds a CODEC Proc 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.
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.
MMIO_FINDPROC
Finds a matching entry from the MMPMMMIO.INI file. This fills in the remainder of the CODECINIFILEINFO. 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_MATCHFIRST 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 CODECINIFILEINFO structure is returned in the pCODECIniFileInfo parameter.
MMIO_MATCHNEXT
If no match flags are specified, finds the next CODEC entry in the MMPMMMIO.INI file following the entry passed in pCODECIniFileInfo. If match flags are specified, finds the next entry that matches the search criteria specified by the flags. In either case, the pCODECIniFileInfo structure is returned.
MMIO_MATCHCOMPRESSTYPE
Uses compression type (ulCompressType field of CODECINIFILEINFO) as a search criteria.
MMIO_MATCHCOMPRESSSUBTYPE
Uses compression subtype (ulCompressSubType field of CODECINIFILEINFO) as a search criteria.
MMIO_MATCHHWID
Uses hardware ID (szHWID field of CODECINIFILEINFO) as a search criteria.
MMIO_MATCHCAPSFLAGS
Uses capability flags (ulCapsFlags of CODECINIFILEINFO) as a search criteria. Note that this search is not based on the exact match. If the target entry contains the flags, the match is satisfied.
MMIO_MATCHFOURCC
Uses the FOURCC code (fcc field of CODECINIFILEINFO) as a search criteria.
MMIO_MATCHDLL
Uses the DLL Name (szDLLName field of CODECINIFILEINFO) as a search criteria.
MMIO_MATCHPROCEDURENAME
Uses the case-sensitive Procedure Name (szProcName field of CODECINIFILEINFO) as a search criteria.
MMIO_FULLPATH
Uses the drive or path given with the DLL name (szDLLName field of CODECINIFILEINFO), otherwise use only the base file name. This allows DLLs with the same base name to be loaded from different directories.

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.
MMIO_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 CODEC procedure name.
MMIOERR_MATCH_NOT_FOUND
Unable to FIND the FOURCC, compression, DLL, or procedure name in MMPMMMIO.INI.
MMIOERR_CODEC_NOT_SUPPORTED
Although the file format is supported, the particular CODEC is not.

---

[Back] [Next]