MFDeserializeAttributesFromStream function (mfobjects.h)

Loads attributes from a stream into an attribute store.

Syntax

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

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.

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

Return code	Description
S_OK	The method succeeded.

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.

This function deletes any attributes that were previously stored in pAttr.

Requirement	Value
Minimum supported client	Windows Vista [desktop apps \| UWP apps]
Minimum supported server	Windows Server 2008 [desktop apps \| UWP apps]
Target Platform	Windows
Header	mfobjects.h (include Mfidl.h)
Library	Mfplat.lib
DLL	Mfplat.dll