PFNDDXGIDDI_PRESENTCB callback function (dxgiddi.h)

The pfnPresentCbDXGI function copies content from a source allocation to a destination allocation.

Syntax

PFNDDXGIDDI_PRESENTCB PfnddxgiddiPresentcb;

HRESULT PfnddxgiddiPresentcb(
  HANDLE hDevice,
  DXGIDDICB_PRESENT *unnamedParam2
)
{...}

Parameters

hDevice

[in] A handle to a display device (graphics context).

unnamedParam2

[in] pPresentData is a pointer to a DXGIDDICB_PRESENT structure that describes the source and destination allocations that content is copied from and to.

Return value

pfnPresentCbDXGI returns one of the following values:

Return code Description
S_OK Content was successfully copied.
E_OUTOFMEMORY pfnPresentCbDXGI could not complete because of insufficient memory.
E_INVALIDARG Parameters were validated and determined to be incorrect.

Remarks

The pDXGIContext member of the DXGIDDICB_PRESENT structure that the pPresentData parameter points to is an opaque communication mechanism. The runtime passes this DXGI context to the driver in the pDXGIContext member of the DXGI_DDI_ARG_PRESENT structure when the runtime calls the driver's PresentDXGI function. The driver should copy this DXGI context unchanged to the pDXGIContext member of DXGIDDICB_PRESENT when the driver calls pfnPresentCbDXGI.

The Direct3D runtime restricts the set of formats that can be presented through a bit-block transfer (bitblt) operation. For more information about the restrictions, see the Remarks section of the BltDXGI reference page.

Requirements

Requirement Value
Minimum supported client Windows Vista
Target Platform Desktop
Header dxgiddi.h (include D3d10umddi.h)

See also

BltDXGI

CreateDevice(D3D10)

DXGIDDICB_PRESENT

DXGI_DDI_ARG_PRESENT

DXGI_DDI_BASE_CALLBACKS

PresentDXGI