PFNDDXGIDDI_PRESENTCB callback function (dxgiddi.h)

Article
02/22/2024

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)