D3DDDICB_PRESENTMULTIPLANEOVERLAY structure (d3dumddi.h)
Describes multiplane overlay allocations that content is copied to and from.
Syntax
typedef struct D3DDDICB_PRESENTMULTIPLANEOVERLAY {
[in] HANDLE hContext;
[in] UINT BroadcastContextCount;
HANDLE BroadcastContext[D3DDDI_MAX_BROADCAST_CONTEXT];
[in] UINT AllocationInfoCount;
D3DDDI_MULTIPLANE_ALLOCATION_INFO AllocationInfo[D3DDDI_MAX_MULTIPLANE_OVERLAY_ALLOCATIONS];
} D3DDDICB_PRESENTMULTIPLANEOVERLAY;
Members
[in] hContext
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.
[in] BroadcastContextCount
The number of additional contexts in the array that the BroadcastContext member specifies.
[in] BroadcastContext[D3DDDI_MAX_BROADCAST_CONTEXT]
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.
[in] AllocationInfoCount
The number of allocations in the array that the AllocationInfo member specifies. The maximum number is 16, the value of the D3DDDI_MAX_MULTIPLANE_OVERLAY_ALLOCATIONS constant.
AllocationInfo[D3DDDI_MAX_MULTIPLANE_OVERLAY_ALLOCATIONS]
An array of structures of type D3DDDI_MULTIPLANE_ALLOCATION_INFO that specify info about the multiplane overlay allocations.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 8.1 |
| Minimum supported server | Windows Server 2012 R2 |
| Header | d3dumddi.h (include D3dumddi.h) |