MFSerializeAttributesToStream 函式 (mfobjects.h)

將屬性存放區的內容寫入資料流程。

語法

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

pAttr

屬性存放區之 IMFAttributes 介面的指標。

dwOptions

MF_ATTRIBUTE_SERIALIZE_OPTIONS列舉中零個或多個旗標的位OR。

pStm

儲存屬性之資料流程之 IStream 介面的指標。

函式會傳回 HRESULT。可能的值包括 (但不限於) 下表中的這些值。

傳回碼	描述
S_OK	此方法已成功。

如果 dwOptions 包含MF_ATTRIBUTE_SERIALIZE_UNKNOWN_BYREF旗標，函式會在屬性存放區中序列化 IUnknown 指標，如下所示：

如果IStream指標透過QueryInterface) 公開IMFObjectReferenceStream介面 (，函式會呼叫IMFObjectReferenceStream：：SaveReference來序列化每個指標。
否則，函式會呼叫 CoMarshalInterface 來序列化物件的 Proxy。

如果 dwOptions 不包含MF_ATTRIBUTE_SERIALIZE_UNKNOWN_BYREF旗標，函式會略過屬性存放區中的 IUnknown 指標。

若要從資料流程載入屬性，請呼叫 MFDeserializeAttributesFromStream。

此函式的主要目的是跨進程界限封送處理屬性。


最低支援的用戶端	Windows Vista [傳統型應用程式 \|UWP 應用程式]
最低支援的伺服器	Windows Server 2008 [傳統型應用程式 \|UWP 應用程式]
目標平台	Windows
標頭	mfobjects.h (包含 Mfidl.h)
程式庫	Mfplat.lib
Dll	Mfplat.dll