MFDeserializeAttributesFromStream

Loads attributes from a stream into an attribute store.

Syntax

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

Parameters

pAttr
Type: IMFAttributes *

Pointer to the IMFAttributes interface of the attribute store.

dwOptions
Type: DWORD 

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

pStm
Type: IStream *

Pointer to the IStream interface of the stream from which to read the attributes.

Return value

Type: HRESULT 

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

Return codes

Refer to Media Foundation return codes.

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.
  

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

Requirements

Header: Declared in mfobjects.h.

Library: Use mfplat.lib.