DXGIDDICB_PRESENT_MULTIPLANE_OVERLAY结构（dxgiddi.h）

项目
02/06/2025

描述内容复制到和从中复制的多平面覆盖分配。

语法

typedef struct DXGIDDICB_PRESENT_MULTIPLANE_OVERLAY {
  [in] void                                       *pDXGIContext;
  [in] HANDLE                                     hContext;
  [in] UINT                                       BroadcastContextCount;
       HANDLE                                     BroadcastContext[D3DDDI_MAX_BROADCAST_CONTEXT];
  [in] DWORD                                      AllocationInfoCount;
       DXGIDDI_MULTIPLANE_OVERLAY_ALLOCATION_INFO AllocationInfo[DXGI_DDI_MAX_MULTIPLANE_OVERLAY_ALLOCATIONS];
} DXGIDDICB_PRESENT_MULTIPLANE_OVERLAY;

成员

[in] pDXGIContext

Microsoft DirectX 图形基础结构（DXGI）上下文的句柄。此句柄对驱动程序不透明。驱动程序应从 pDXGIContext 成员分配驱动程序在调用其 pfnPresentMultiplaneOverlay （DXGI）函数时收到的 DXGI_DDI_ARG_PRESENTMULTIPLANEOVERLAY 结构的句柄。

[in] hContext

驱动程序将复制作提交到的上下文的句柄。用户模式显示驱动程序以前通过调用 pfnCreateContextCb 函数来创建此上下文。

[in] BroadcastContextCount

BroadcastContext 成员指定的数组中的其他上下文数。

[in] BroadcastContext[D3DDDI_MAX_BROADCAST_CONTEXT]

用于将当前当前作广播到的其他上下文的句柄数组。 D3DDDI_MAX_BROADCAST_CONTEXT 常量（定义为 64）定义用户模式显示驱动程序可以将当前当前作广播到的最大附加上下文数。

仅对翻转作支持广播。若要广播翻转作，显示微型端口驱动程序必须支持基于内存的 I/O（MMIO）翻转。为了指示支持 MMIO 翻转，显示微型端口驱动程序在调用 DxgkDdiQueryAdapterInfo 函数时，在 FlipCapsDXGK_DRIVERCAPS 结构的成员中设置 FlipOnVSyncMmIo 位字段标志。

hContext 成员指定的原始上下文，并且用户模式显示驱动程序呈现给 BroadcastContext 数组中不是元素。例如，如果 BroadcastContext 数组包含一个元素，则用户模式显示驱动程序会将当前作发送到自己的上下文（hContext），并广播到该另一个上下文。

[in] AllocationInfoCount

AllocationInfo 成员指定的数组中的分配数。最大数字为 16，即 DXGI_DDI_MAX_MULTIPLANE_OVERLAY_ALLOCATIONS 常量的值。

AllocationInfo[DXGI_DDI_MAX_MULTIPLANE_OVERLAY_ALLOCATIONS]

DXGIDDI_MULTIPLANE_OVERLAY_ALLOCATION_INFO 类型的结构数组，用于指定有关多平面覆盖分配的信息。