DXGI_DDI_ARG_PRESENT1 结构 (dxgiddi.h)

项目
08/07/2023

描述要显示的资源。与 pfnPresent1 (DXGI) 函数一起使用，由 Windows 显示驱动程序模型 (WDDM) 1.3 及更高版本的用户模式显示驱动程序。

语法

typedef struct DXGI_DDI_ARG_PRESENT1 {
  [in] DXGI_DDI_HDEVICE                  hDevice;
  [in] const DXGI_DDI_ARG_PRESENTSURFACE *phSurfacesToPresent;
  [in] UINT                              SurfacesToPresent;
  [in] DXGI_DDI_HRESOURCE                hDstResource;
  [in] UINT                              DstSubResourceIndex;
  [in] void                              *pDXGIContext;
  [in] DXGI_DDI_PRESENT_FLAGS            Flags;
  [in] DXGI_DDI_FLIP_INTERVAL_TYPE       FlipInterval;
       UINT                              Reserved;
  [in] const RECT                        *pDirtyRects;
  [in] UINT                              DirtyRects;
       UINT                              BackBufferMultiplicity;
} DXGI_DDI_ARG_PRESENT1;

成员

[in] hDevice

显示设备的句柄 (图形上下文) 驱动程序执行演示。当运行时调用驱动程序的 CreateDevice (D3D10) 函数来创建显示设备时，Direct3D 运行时将此句柄传递给 D3D10DDIARG_CREATEDEVICE 结构的 hDrvDevice 成员中的驱动程序。

[in] phSurfacesToPresent

要显示或释放的源资源的非 NULL 句柄和从零开始的索引的数组。 phSurfacesToPresent 始终是资源要显示的有效句柄。

[in] SurfacesToPresent

要呈现的图面数组。不得为零。

[in] hDstResource

要显示的目标资源的句柄。如果目标未知， hDstResource 可以为 NULL ;内核模式将在通过 DMA 将硬件命令流发送到图形处理器之前确定目标。

当提供许多资源时， hDstResource 将为 NULL，并且驱动程序必须仅转换最后一个源资源句柄以用于 pfnPresentCb 函数。

[in] DstSubResourceIndex

目标资源的从零开始的索引， hDstResource 成员中的句柄指定该索引。 DstSubResourceIndex 索引指示要显示到的子资源或图面。

[in] pDXGIContext

DXGI 上下文的句柄。此句柄对驱动程序不透明。当驱动程序调用 pfnPresentCbDXGI 函数时，驱动程序必须将此成员中的句柄作为DXGIDDICB_PRESENT结构的 pDXGIContext 成员传递。

[in] Flags

一个DXGI_DDI_PRESENT_FLAGS结构，用于在位字段标志中标识如何执行当前操作。

[in] FlipInterval

一个DXGI_DDI_FLIP_INTERVAL_TYPE类型的值，指示翻转间隔 (即，如果翻转发生在零、一、二、三或四个垂直同步之后，) 。

Reserved

此成员为保留成员，应设置为零。

[in] pDirtyRects

指向脏矩形数组的指针， (相对于源矩形 SrcRect 的 RECT) ，指示已更改的覆盖平面部分。

驱动程序可以使用此成员来执行优化，但不需要使用脏矩形信息。但是，驱动程序不应根据提供的脏矩形使函数调用失败。

[in] DirtyRects

pDirtyRects 指向的数组中的脏矩形数。

BackBufferMultiplicity

每个逻辑后台缓冲区的物理后台缓冲区数。

要求

要求	值
最低受支持的客户端	Windows 8.1，WDDM 1.3 及更高版本
最低受支持的服务器	Windows Server 2012 R2
标头	dxgiddi.h (包括 D3d10umddi.h)