FILE_FORMAT_DESC

Describes the format of the multimedia file to be written. This structure is used by mmOpenFile when it is invoked in write mode, to configure the file format.

Definition

typedef struct
{
    char     format [8];
    DWORD    version;
    DWORD    flags;
    DWORD    maxFileSize;
    DWORD    maxFileTime;
    DWORD    interleave;
} FILE_FORMAT_DESC;

Fields

Field

Description

format [8]

File format string. For 3GP file format, this field specifies the major brand string. The default is 3GP6. A value of NULL indicates the default format.

version

Format version of the file. For 3GP files, the format is (x * 256 + y), which refers to TS 26.244 v6.x.y. The default is 256.

flags

Specifies how to store media data in the file when the mmWriteStream function is invoked. Valid values:

  • FORMAT_FLAG_WR_NORMAL (default) - Store media data in temporary storage.

  • FORMAT_FLAG_WR_DIRECT -Store media data directly in the file.

  • FORMAT_FLAG_TEMP_MEM - Use allocated memory to store media data.

  • FORMAT_FLAG_TEMP_FILE - Store media data in intermediate files.

maxFileSize

Maximum file size, in bytes, for all media streams. A value of 0 (zero) indicates that the file size is not limited.

maxFileTime

Maximum file duration, in milliseconds, for all included media streams. A value of 0 (zero) indicates that the time is not limited.

interleave

Maximum interleave depth in presentation, in milliseconds. A value of 0 (zero) indicates that media streams are interleaved by 250 milliseconds.