IMF2DBuffer::ContiguousCopyTo method (mfobjects.h)

Article
10/13/2021

Copies this buffer into the caller's buffer, converting the data to contiguous format.

Syntax

HRESULT ContiguousCopyTo(
  [out] BYTE  *pbDestBuffer,
  [in]  DWORD cbDestBuffer
);

Parameters

[out] pbDestBuffer

Pointer to the destination buffer where the data will be copied. The caller allocates the buffer.

[in] cbDestBuffer

Size of the destination buffer, in bytes. To get the required size, call IMF2DBuffer::GetContiguousLength.

Return value

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

Return code	Description
S_OK	The method succeeded.
E_INVALIDARG	Invalid size specified in pbDestBuffer.

Remarks

If the original buffer is not contiguous, this method converts the contents into contiguous format during the copy. For a definition of contiguous as it applies to 2-D buffers, see the Remarks section in IMF2DBuffer interface.

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	mfobjects.h (include Mfidl.h)
Library	Mfuuid.lib