pfnPresentMultiPlaneOverlayCb (D3D) function

Copies content from a source multiplane overlay allocation to a destination allocation. Can be called by Windows Display Driver Model (WDDM) 1.3 or later user-mode display drivers.

Syntax


_Check_return_ HRESULT APIENTRY CALLBACK* pfnPresentMultiPlaneOverlayCb(
  _In_  HANDLE hDevice,
  _In_  const D3DDDICB_PRESENTMULTIPLANEOVERLAY *pPresent
);

Parameters

hDevice [in]

A handle to a display device (graphics context).

pPresent [in]

A pointer to a D3DDDICB_PRESENTMULTIPLANEOVERLAY structure that describes the source and destination allocations that content is copied from and to.

Return value

Returns one of these values:

Return codeDescription
S_OK

Content was successfully copied.

E_OUTOFMEMORY

The function could not complete because of insufficient memory.

E_INVALIDARG

Parameters were validated and determined to be incorrect.

 

Remarks

The user-mode display driver should call this function only after it has successfully processed a call by the Microsoft DirectX Graphics Infrastructure (DXGI) runtime to the pfnPresentMultiplaneOverlay (D3D) function.

Note  When the display driver calls pfnPresentMultiPlaneOverlayCb (D3D), it must maintain the same order of allocations in the AllocationInfo array member of the D3DDDICB_PRESENTMULTIPLANEOVERLAY structure as it received from the Microsoft Direct3D runtime when the runtime called pfnPresentMultiplaneOverlay (D3D).

For example, the allocation handle in index 1 of AllocationInfo must represent the same resource that was passed to the driver in index 1 of the pPresentPlanes member of the D3DDDIARG_PRESENTMULTIPLANEOVERLAY structure used with pfnPresentMultiplaneOverlay (D3D).

Requirements

Minimum supported client

Windows 8.1

Minimum supported server

Windows Server 2012 R2

Header

D3dumddi.h (include D3dumddi.h)

See also

D3DDDIARG_PRESENTMULTIPLANEOVERLAY
D3DDDICB_PRESENTMULTIPLANEOVERLAY
pfnPresentMultiplaneOverlay (D3D)

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft