Funzione MFSerializeAttributesToStream (mfobjects.h)

Scrive il contenuto di un archivio attributi in un flusso.

Sintassi

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

Parametri

pAttr

Puntatore all'interfaccia FMAttributes dell'archivio attributi.

dwOptions

OR bit per bit di zero o più flag dall'enumerazione MF_ATTRIBUTE_SERIALIZE_OPTIONS.

pStm

Puntatore all'interfaccia IStream del flusso in cui vengono salvati gli attributi.

Valore restituito

La funzione restituisce un HRESULT. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente.

Codice restituito	Descrizione
S_OK	Il metodo è riuscito.

Commenti

Se dwOptions contiene il flag di MF_ATTRIBUTE_SERIALIZE_UNKNOWN_BYREF, la funzione serializza i puntatori IUnknown nell'archivio attributi, come indicato di seguito:

• Se il puntatore IStream espone l'interfaccia IMFObjectReferenceStream (tramite QueryInterface), la funzione chiama FMObjectReferenceStream::SaveReferenceStream per serializzare ogni puntatore.
• In caso contrario, la funzione chiama CoMarshalInterface per serializzare un proxy per l'oggetto.

Se dwOptions non include il flag MF_ATTRIBUTE_SERIALIZE_UNKNOWN_BYREF, la funzione ignora i puntatori IUnknown nell'archivio attributi.

Per caricare gli attributi dal flusso, chiamare MFDeserializeAttributesFromStream.

Lo scopo principale di questa funzione è il marshalling degli attributi tra i limiti del processo.

Requisiti

Client minimo supportato	Windows Vista [app desktop | App UWP]
Server minimo supportato	Windows Server 2008 [app desktop | App UWP]
Piattaforma di destinazione	Windows
Intestazione	mfobjects.h (include Mfidl.h)
Libreria	Mfplat.lib
DLL	Mfplat.dll

Vedi anche

Attributi e proprietà

Funzioni di Media Foundation