IMFSample::ConvertToContiguousBuffer Method

Converts a sample with multiple buffers into a sample with a single buffer.

Syntax

public:
HRESULT ConvertToContiguousBuffer(
         IMFMediaBuffer **ppBuffer
)

Parameters

ppBuffer
Type: IMFMediaBuffer **

[out]

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

Return value

Type: HRESULT

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

Return codes

Return code	Description
S_OK	The method succeeded.
E_UNEXPECTED	The sample does not contain any buffers.

Refer to Media Foundation return codes.

Remarks

If the sample contains more than one buffer, this method copies the data from the original buffers into a new buffer, and replaces the original buffer list with the new buffer. The new buffer is returned in the ppBuffer parameter.

If the sample contains a single buffer, this method returns a pointer to the original buffer. In typical use, most samples do not contain multiple buffers.

Requirements

Header: Declared in mfobjects.h (include mfidl.h).

Library: Use mfuuid.lib.