Fonction MFSerializeAttributesToStream (mfobjects.h)

Article
08/24/2023

Écrit le contenu d’un magasin d’attributs dans un flux.

Syntaxe

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

Paramètres

pAttr

Pointeur vers l’interface IMFAttributes du magasin d’attributs.

dwOptions

OR au niveau du bit de zéro ou plusieurs indicateurs de l’énumération MF_ATTRIBUTE_SERIALIZE_OPTIONS.

pStm

Pointeur vers l’interface IStream du flux où les attributs sont enregistrés.

Valeur retournée

La fonction retourne un HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.

Code de retour	Description
S_OK	S_OK

Notes

Si dwOptions contient l’indicateur MF_ATTRIBUTE_SERIALIZE_UNKNOWN_BYREF, la fonction sérialise les pointeurs IUnknown dans le magasin d’attributs, comme suit :

Si le pointeur IStream expose l’interface IMFObjectReferenceStream (via QueryInterface), la fonction appelle IMFObjectReferenceStream::SaveReference pour sérialiser chaque pointeur.
Sinon, la fonction appelle CoMarshalInterface pour sérialiser un proxy pour l’objet .

Si dwOptions n’inclut pas l’indicateur MF_ATTRIBUTE_SERIALIZE_UNKNOWN_BYREF, la fonction ignore les pointeurs IUnknown dans le magasin d’attributs.

Pour charger les attributs à partir du flux, appelez MFDeserializeAttributesFromStream.

L’objectif main de cette fonction est de marshaler les attributs au-delà des limites de processus.

Configuration requise


Client minimal pris en charge	Windows Vista [applications de bureau \| applications UWP]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau \| applications UWP]
Plateforme cible	Windows
En-tête	mfobjects.h (include Mfidl.h)
Bibliothèque	Mfplat.lib
DLL	Mfplat.dll

Voir aussi

Attributs et propriétés

Fonctions Media Foundation

Share via