MFGetAttributesAsBlob function (mfapi.h)

Converts the contents of an attribute store to a byte array.

Syntax

HRESULT MFGetAttributesAsBlob(
  [in]  IMFAttributes *pAttributes,
  [out] UINT8         *pBuf,
  [in]  UINT          cbBufSize
);

Parameters

[in] pAttributes

Pointer to the IMFAttributes interface of the attribute store.

[out] pBuf

Pointer to an array that receives the attribute data.

[in] cbBufSize

Size of the pBuf array, in bytes. To get the required size of the buffer, call MFGetAttributesAsBlobSize.

Return value

The function returns an HRESULT. Possible values include, but are not limited to, those in the following table.

Return code Description
S_OK
The function succeeded.
MF_E_BUFFERTOOSMALL
The buffer given in pBuf is too small.

Remarks

The function skips any attributes with IUnknown pointer values (MF_ATTRIBUTE_IUNKNOWN); they are not stored in the array.

To convert the byte array back into an attribute store, call MFInitAttributesFromBlob.

To write an attribute store to a stream, call the MFSerializeAttributesToStream function.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps | UWP apps]
Minimum supported server Windows Server 2008 [desktop apps | UWP apps]
Target Platform Windows
Header mfapi.h
Library Mfplat.lib
DLL Mfplat.dll

See also

Attributes and Properties

Media Foundation Functions