IMediaPropertyBag Interface

 
Microsoft DirectShow 9.0

IMediaPropertyBag Interface

The IMediaPropertyBag interface is exposed by the Media Property Bag object. The Media Property Bag is a specialized version of the standard COM property bag, designed for setting and retrieving INFO and DISP chunks in Audio-Video Interleaved (AVI) files.

An INFO chunk contains meta-information about a file, such as author and copyright information. A DISP chunk contains data in Clipboard format. For more information, refer to the resource interchange file format (RIFF) specification.

The media property bag stores the chunks as name/value pairs, as follows:

  • INFO chunks: The name is a string with the form INFO/XXXX, where XXXX is the four-character code that defines the type of meta-information—for example, ICOP for copyright information and IART for author name. The value is any string.
  • DISP chunks: The name is a string with the form DISP/0000000000, where 0000000000 is the 10-character decimal equivalent of a standard Clipboard format—for example, 0000000008 for CF_DIB. The value is an array of bytes that contains the display data.

This interface inherits the IPropertyBag interface. Use this interface with the IPersistMediaPropertyBag interface to retrieve INFO and DISP chunks from an AVI file.

In addition to the methods inherited from IPropertyBag, the IMediaPropertyBag interface exposes the following method.

Method Description
EnumProperty Retrieves a property/value pair.

Requirements

Header: Declared in Strmif.h; include Dshow.h.

Library: Use Strmiids.lib.