IPersistMediaPropertyBag::Save

  • Article
 
Microsoft DirectShow 9.0

IPersistMediaPropertyBag::Save

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

Syntax

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

Parameters

pPropBag

[in] Pointer to the IMediaPropertyBag interface of a media property bag created by the caller.

fClearDirty

[in] Reserved. Can be any value.

fSaveAllProperties

[in] Reserved. Can be any value.

Return Value

Returns an HRESULT value. Possible values include the following:

Value Description
S_OK Success.
E_NOTIMPL Not implemented.
E_OUTOFMEMORY Insufficient memory.
HRESULT_FROM_WIN32(ERROR_INVALID_DATA) Invalid data.

Remarks

If you call this method on the AVI Splitter filter or the WAVE Parser, the filter reads any INFO and DISP chunks from the file and stores them in the media property bag. You can use the IMediaPropertyBag::Read or IMediaPropertyBag::EnumProperty method to retrieve the chunks.

The AVI Muxfilter does not implement this method.

Requirements

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

Library: Use Strmiids.lib.

See Also