AVIMETAINDEX structure (aviriff.h)

  • Article

[The feature associated with this page, DirectShow, is a legacy feature. It has been superseded by MediaPlayer, IMFMediaEngine, and Audio/Video Capture in Media Foundation. Those features have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer, IMFMediaEngine and Audio/Video Capture in Media Foundation instead of DirectShow, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]

The base structure for an AVI 2.0 index ('indx' format).

Syntax

typedef struct _avimetaindex {
  FOURCC fcc;
  UINT   cb;
  WORD   wLongsPerEntry;
  BYTE   bIndexSubType;
  BYTE   bIndexType;
  DWORD  nEntriesInUse;
  DWORD  dwChunkId;
  DWORD  dwReserved[3];
  DWORD  adwIndex[];
} AVIMETAINDEX;

Members

fcc

A FOURCC code. The value is either 'indx' or 'nnix', where nn is the stream number.

cb

The size of the structure, not including the initial 8 bytes.

wLongsPerEntry

The size of each index entry, in 4-byte units.

bIndexSubType

The index subtype. The meaning depends on the value of bIndexType.

bIndexType

The index type.

Value Meaning
AVI_INDEX_OF_INDEXES
0x00
 Each index entry points to another index. Treat the AVIMETAINDEX structure as an AVISUPERINDEX structure. The value of bIndexSubType must be zero.
AVI_INDEX_OF_CHUNKS
0x01
 Each index entry points to a data chunk in the file.
  • If bIndexSubType is 0, treat the AVIMETAINDEX structure as an AVISTDINDEX structure. Each index entry is an AVISTDINDEX_ENTRY structure.
  • If bIndexSubType is AVI_INDEX_SUB_2FIELD, the index is a field index chunk.
    Note  DirectShow does not support field indexes.
     
AVI_INDEX_IS_DATA
0x80
 The adwIndex array contains a table of data, not a list of index entries.

nEntriesInUse

The number of valid entries in the adwIndex array.

dwChunkId

A FOURCC that identifies the object that is indexed. If the indexed object is a stream, this member has the same meaning as the dwChunkId member of the AVIOLDINDEX structure.

dwReserved[3]

The meaning of this member depends on the index type.

adwIndex

An array of index entries. The format of this data depends on the index type.

Remarks

For more information, see the OpenDML AVI File Format Extensions, published by the OpenDML AVI M-JPEG File Format Subcommittee. (This resource may not be available in some languages

and countries.)

Requirements

Requirement Value
Header aviriff.h

See also

AVI RIFF File Reference

DirectShow Structures