Edit

Share via

IPersistMediaPropertyBag interface (strmif.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 IPersistMediaPropertyBag interface sets and retrieves INFO and DISP chunks in Audio-Video Interleaved (AVI) streams. It uses the IMediaPropertyBag interface to store the chunks as name/value pairs.

The AVI Splitter filter and the WAVE Parser filter support this interface for reading INFO and DISP chunks from an AVI or WAV file. The AVI Mux filter supports the interface for writing these chunks into a file.

IPersistMediaPropertyBag is modeled after, but does not inherit from, the IPersistPropertyBag interface. For more information on IPersistPropertyBag, see the Platform SDK.

Inheritance

The IPersistMediaPropertyBag interface inherits from the IUnknown interface. IPersistMediaPropertyBag also has these types of members:

Methods

The IPersistMediaPropertyBag interface has these methods.

 
IPersistMediaPropertyBag::InitNew

The InitNew method initializes the object to receive new properties.
IPersistMediaPropertyBag::Load

The Load method loads properties from the media property bag into the filter.
IPersistMediaPropertyBag::Save

The Save method saves properties from the filter into the media property bag.

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header strmif.h (include Dshow.h)