MFSerializeAttributesToStream 함수(mfobjects.h)

특성 저장소의 내용을 스트림에 씁니다.

구문

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

pAttr

특성 저장소의 IMFAttributes 인터페이스에 대한 포인터입니다.

dwOptions

MF_ATTRIBUTE_SERIALIZE_OPTIONS 열거형에서 0개 이상의 플래그의 비트 OR입니다.

pStm

특성이 저장되는 스트림의 IStream 인터페이스에 대한 포인터입니다.

함수는 HRESULT를 반환합니다. 가능한 값에는 다음 표에 있는 값이 포함되지만, 이에 국한되는 것은 아닙니다.

반환 코드	Description
S_OK	메서드가 성공했습니다.

dwOptions에 MF_ATTRIBUTE_SERIALIZE_UNKNOWN_BYREF 플래그가 포함된 경우 함수는 다음과 같이 특성 저장소의 IUnknown 포인터를 직렬화합니다.

IStream 포인터가 QUERYInterface를 통해 IMFObjectReferenceStream 인터페이스를 노출하는 경우 함수는 IMFObjectReferenceStream::SaveReference를 호출하여 각 포인터를 직렬화합니다.
그렇지 않으면 함수는 CoMarshalInterface 를 호출하여 개체에 대한 프록시를 직렬화합니다.

dwOptions에 MF_ATTRIBUTE_SERIALIZE_UNKNOWN_BYREF 플래그가 포함되지 않은 경우 함수는 특성 저장소에서 IUnknown 포인터를 건너뜁니다.

이 함수의 기본 목적은 프로세스 경계를 넘어 특성을 마샬링하는 것입니다.