Skip to content

Latest commit

 

History

History
117 lines (77 loc) · 4.48 KB

ns-d3dumddi-_d3dddicb_present.md

File metadata and controls

117 lines (77 loc) · 4.48 KB
UID title description old-location tech.root ms.date keywords ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames f1_keywords topic_type api_type api_location api_name
NS:d3dumddi._D3DDDICB_PRESENT
_D3DDDICB_PRESENT (d3dumddi.h)
The D3DDDICB_PRESENT structure describes allocations that content is copied to and from.
display\d3dddicb_present.htm
display
05/10/2018
D3DDDICB_PRESENT structure
D3DDDICB_PRESENT, D3DDDICB_PRESENT structure [Display Devices], D3D_param_Structs_969f252f-fe5c-4351-9c7a-746fd33cb405.xml, _D3DDDICB_PRESENT, d3dumddi/D3DDDICB_PRESENT, display.d3dddicb_present
d3dumddi.h
D3dumddi.h
Windows
Available in Windows Vista and later versions of the Windows operating systems.
Windows
D3DDDICB_PRESENT
_D3DDDICB_PRESENT
d3dumddi/_D3DDDICB_PRESENT
D3DDDICB_PRESENT
d3dumddi/D3DDDICB_PRESENT
APIRef
kbSyntax
HeaderDef
d3dumddi.h
_D3DDDICB_PRESENT
D3DDDICB_PRESENT

_D3DDDICB_PRESENT structure

-description

The D3DDDICB_PRESENT structure describes allocations that content is copied to and from.

-struct-fields

-field hSrcAllocation [in]

A D3DKMT_HANDLE data type that represents a kernel-mode handle to the source allocation. The Microsoft Direct3D runtime's pfnAllocateCb function returns this handle. Therefore, the user-mode display driver should use this handle to copy content from.

-field hDstAllocation [in]

A D3DKMT_HANDLE data type that represents a kernel-mode handle to the destination allocation. hDstAllocation can be zero if the destination is unknown; kernel mode will determine the destination just before DMA of the hardware command stream to the graphics processor.

-field hContext [in]

A handle to the context that the driver submits the copy operation to. The user-mode display driver previously created this context by calling the pfnCreateContextCb function.

-field BroadcastContextCount [in]

The number of additional contexts in the array that the BroadcastContext member specifies.

-field BroadcastContext [in]

An array of handles to the additional contexts to broadcast the current present operation to. The D3DDDI_MAX_BROADCAST_CONTEXT constant, which is defined as 64, defines the maximum number of additional contexts that the user-mode display driver can broadcast the current present operation to.

Broadcasting is supported only for flip operations. To broadcast a flip operation, the display miniport driver must support memory mapped I/O (MMIO)-based flips. To indicate support of MMIO flips, the display miniport driver sets the FlipOnVSyncMmIo bit-field flag in the FlipCaps member of the DXGK_DRIVERCAPS structure when its DxgkDdiQueryAdapterInfo function is called.

The original context that the hContext member specifies and that the user-mode display driver presents to is not an element in the BroadcastContext array. For example, if the BroadcastContext array contains one element, the user-mode display driver sends the present operation to the owning context (hContext) and broadcasts to that one additional context.

-field BroadcastSrcAllocation

Allocations which content will be presented.

-field BroadcastDstAllocation

If non-zero, represents the destination allocations of the present.

-field PrivateDriverDataSize

Private driver data size in bytes.

-field pPrivateDriverData

Private driver data to pass to DdiPresent.

-field bOptimizeForComposition

DWM is involved in composition.

-field SyncIntervalOverrideValid

Override app sync interval is valid.

-field SyncIntervalOverride

Override app sync interval.

-see-also

pfnAllocateCb

pfnPresentCb