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.
| Return code | Description |
|---|---|
|
The method succeeded. |
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
| 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 |