pfnPresentCbDXGI routine

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

Syntax


PFNDDXGIDDI_PRESENTCB pfnPresentCbDXGI;

HRESULT pfnPresentCbDXGI(
  _In_       HANDLE            hDevice,
  _In_ const DXGIDDICB_PRESENT *pPresentData
)
{ ... }

Parameters

hDevice [in]

A handle to a display device (graphics context).

pPresentData [in]

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 codeDescription
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

Target platform

Desktop

Version

Available in Windows Vista and later versions of the Windows operating systems.

Header

Dxgiddi.h (include D3d10umddi.h)

See also

BltDXGI
CreateDevice(D3D10)
DXGI_DDI_ARG_PRESENT
DXGI_DDI_BASE_CALLBACKS
DXGIDDICB_PRESENT
PresentDXGI

 

 

Send comments about this topic to Microsoft

Show:
© 2015 Microsoft