MFSerializeAttributesToStream function (mfobjects.h)

Writes the contents of an attribute store to a stream.

Syntax

HRESULT MFSerializeAttributesToStream(
  IMFAttributes *pAttr,
  DWORD         dwOptions,
  IStream       *pStm
);

Parameters

pAttr

Pointer to the IMFAttributes interface of the attribute store.

dwOptions

Bitwise OR of zero or more flags from the MF_ATTRIBUTE_SERIALIZE_OPTIONS enumeration.

pStm

Pointer to the IStream interface of the stream where the attributes are saved.

Return value

The function returns an HRESULT. Possible values include, but are not limited to, those in the following table.

Remarks

If dwOptions contains the MF_ATTRIBUTE_SERIALIZE_UNKNOWN_BYREF flag, the function serializes IUnknown pointers in the attribute store, as follows:

• If the IStream pointer exposes the IMFObjectReferenceStream interface (through QueryInterface), the function calls IMFObjectReferenceStream::SaveReference to serialize each pointer.
• Otherwise, the function calls CoMarshalInterface to serialize a proxy for the object.

To load the attributes from the stream, call MFDeserializeAttributesFromStream.

The main purpose of this function is to marshal attributes across process boundaries.

Requirements

See also

Attributes and Properties

Media Foundation Functions