MFCreateMemoryBuffer

Allocates system memory and creates a media buffer to manage it.

Syntax

HRESULT MFCreateMemoryBuffer(
         DWORD cbMaxLength,
         IMFMediaBuffer **ppBuffer
)  

Parameters

cbMaxLength
Type: DWORD 

[in]

Size of the buffer, in bytes.

ppBuffer
Type: IMFMediaBuffer **

[out]

Receives a pointer to the IMFMediaBuffer interface of the media buffer. The caller must release the interface.

Return value

Type: HRESULT 

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

Return codes

Refer to Media Foundation return codes.

Remarks

The function allocates a buffer with a 1-byte memory alignment. To allocate a buffer that is aligned to a larger memory boundary, call MFCreateAlignedMemoryBuffer.

When the media buffer object is destroyed, it releases the allocated memory.

Requirements

Header: Declared in mfapi.h.

Library: Use Mfplat.lib.