IPersistMediaPropertyBag Interface

The IPersistMediaPropertyBag interface retrieves and stores properties associated with INFO chunks in Audio-Video Interleaved (AVI) and WAV files. The AVI Splitter filter supports this interface for reading these properties and the AVI MUX filter supports it for writing these properties. IPersistMediaPropertyBag is modeled after (but does not inherit from) IPersistPropertyBag. For more information, see the documentation for IPersistPropertyBag in the Microsoft® Platform Software Development Kit (SDK).

Methods in Vtable Order

IUnknown methods Description
QueryInterface Retrieves pointers to supported interfaces.
AddRef Increments the reference count.
Release Decrements the reference count.

IPersistMediaPropertyBag methods Description

InitNew Initializes a new property bag that will hold the media file header information.
Load Retrieves the properties from the media file and stores them in the property bag.
Save Saves the media file properties.

IUnknown methods	Description
QueryInterface	Retrieves pointers to supported interfaces.
AddRef	Increments the reference count.
Release	Decrements the reference count.
IPersistMediaPropertyBag methods	Description
InitNew	Initializes a new property bag that will hold the media file header information.
Load	Retrieves the properties from the media file and stores them in the property bag.
Save	Saves the media file properties.

IPersistMediaPropertyBag::InitNew

IPersistMediaPropertyBag Interface

Initializes a new property bag that will hold the media file header information.

Syntax

HRESULT InitNew(void);

Return Value

Returns an HRESULT value.

IPersistMediaPropertyBag::Load

IPersistMediaPropertyBag Interface

Retrieves the properties from the media file and stores them in the property bag.

Syntax

HRESULT Load(
    IMediaPropertyBag *pPropBag
    IErrorLog *pErrorLog
);

Parameters

pPropBag
[in] Pointer to the caller's property bag.

pErrorLog
[in] Pointer to the IErrorLog interface for the object that will handle error logging for this property bag.

Return Value

Returns an HRESULT value.

Remarks

IErrorLog is documented in the Microsoft® Platform SDK.

IPersistMediaPropertyBag::Save

IPersistMediaPropertyBag Interface

Saves the media file properties.

Syntax

HRESULT Save(
    IMediaPropertyBag *pPropBag
    BOOL fClearDirty
    BOOL fSaveAllProperties
);

Parameters

pPropBag
[in] Pointer to the caller's property bag.
fClearDirty
[in] Boolean value that specifies whether to clear the dirty flag. TRUE means clear the dirty flag.
fSaveAllProperties
[in] Boolean value that specifies whether to save all properties or just those that have changed. TRUE means to save all properties.

Return Value

Returns an HRESULT value.