This message requests the IOProc to return media-specific information about the current file or file element. This would include such data as resolution and colors for images, and duration and sample rate for audio. Header translation is expected to be performed when specified.

pmmioinfo (PMMIOINFO)

A pointer to an MMIOINFO data structure.

usMsg (USHORT)

Set to MMIOM_GETHEADER.

lParam1 (LONG)

Pointer to a file-specific header structure that will contain information provided by the IOProc.

lParam2 (LONG)

Length in bytes of the structure supplied in lParam1.

rc (ULONG)

• Upon successful completion, the number of bytes copied to the header structure.

• For a failure, 0 is returned.

• If the length passed in was not enough to hold the header, MMIOERR_INVALID_BUFFER_LENGTH is set in ulErrorRet.

• If the header is bad, MMIOERR_INVALID_STRUCTURE is set in ulErrorRet.

---

[Back] [Next]