MFCreateDXGISurfaceBuffer function

Creates a media buffer to manage a Microsoft DirectX Graphics Infrastructure (DXGI) surface.

Syntax

HRESULT MFCreateDXGISurfaceBuffer(
  _In_  REFIID         riid,
  _In_  IUnknown       *punkSurface,
  _In_  UINT           uSubresourceIndex,
  _In_  BOOL           fBottomUpWhenLinear,
  _Out_ IMFMediaBuffer **ppBuffer
);

Parameters

riid [in]

Identifies the type of DXGI surface. This value must be IID_ID3D11Texture2D.

punkSurface [in]

A pointer to the IUnknown interface of the DXGI surface.

uSubresourceIndex [in]

The zero-based index of a subresource of the surface. The media buffer object is associated with this subresource.

fBottomUpWhenLinear [in]

If TRUE, the buffer's IMF2DBuffer::ContiguousCopyTo method copies the buffer into a bottom-up format. The bottom-up format is compatible with GDI for uncompressed RGB images. If this parameter is FALSE, the ContiguousCopyTo method copies the buffer into a top-down format, which is compatible with Direct3D.

For more information about top-down versus bottom-up images, see Image Stride.

ppBuffer [out]

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

Return value

If this function succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

The returned buffer object supports the following interfaces:

• IMF2DBuffer
• IMF2DBuffer2
• IMFDXGIBuffer
• IMFMediaBuffer

Requirements

See also

Media Foundation Functions