MFSerializeAttributesToStream-Funktion (mfobjects.h)

Schreibt den Inhalt eines Attributspeichers in einen Stream.

Syntax

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

pAttr

dwOptions

Bitweise OR mit null oder mehr Flags aus der MF_ATTRIBUTE_SERIALIZE_OPTIONS-Enumeration .

pStm

Zeiger auf die IStream-Schnittstelle des Datenstroms, in dem die Attribute gespeichert werden.

Die Funktion gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode wurde erfolgreich ausgeführt.

Wenn dwOptions das flag MF_ATTRIBUTE_SERIALIZE_UNKNOWN_BYREF enthält, serialisiert die Funktion IUnknown-Zeiger im Attributspeicher wie folgt:

Wenn der IStream-Zeiger die IMFObjectReferenceStream-Schnittstelle (über QueryInterface) verfügbar macht, ruft die Funktion IMFObjectReferenceStream::SaveReference auf, um jeden Zeiger zu serialisieren.
Andernfalls ruft die Funktion CoMarshalInterface auf, um einen Proxy für das -Objekt zu serialisieren.

Wenn dwOptions das flag MF_ATTRIBUTE_SERIALIZE_UNKNOWN_BYREF nicht enthält, überspringt die Funktion IUnknown-Zeiger im Attributspeicher.

Um die Attribute aus dem Stream zu laden, rufen Sie MFDeserializeAttributesFromStream auf.

Der Standard Zweck dieser Funktion besteht darin, Attribute über Prozessgrenzen hinweg zu marshallen.


Unterstützte Mindestversion (Client)	Windows Vista [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	mfobjects.h (include Mfidl.h)
Bibliothek	Mfplat.lib
DLL	Mfplat.dll