MFDeserializeAttributesFromStream function (mfobjects.h)

Loads attributes from a stream into an attribute store.

Syntax

HRESULT MFDeserializeAttributesFromStream(
  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 from which to read the attributes.

Return value

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

Remarks

Use this function to deserialize an attribute store that was serialized with the MFSerializeAttributesToStream function.

If dwOptions contains the MF_ATTRIBUTE_SERIALIZE_UNKNOWN_BYREF flag, the function deserializes IUnknown pointers from the stream, as follows:

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

Requirements

See also

Attributes and Properties

IMFAttributes

MF_ATTRIBUTE_SERIALIZE_OPTIONS

Media Foundation Functions