DXGI_DDI_ARG_PRESENT1结构(dxgiddi.h)

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

语法

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 向图形处理器发送硬件命令流之前确定目标。

呈现多个资源时,hDstResourceNULL,并且驱动程序只能转换最后一个源资源句柄,以便与 pfnPresentCb 函数一起使用。

[in] DstSubResourceIndex

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

[in] pDXGIContext

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

[in] Flags

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

[in] FlipInterval

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

Reserved

此成员是保留的,应设置为零。

[in] pDirtyRects

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

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

[in] DirtyRects

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

BackBufferMultiplicity

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

要求

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

另请参阅

CreateDevice(D3D10)

DXGIDDICB_PRESENT

DXGI_DDI_FLIP_INTERVAL_TYPE

DXGI_DDI_PRESENT_FLAGS

RECT

pfnPresent1(DXGI)

pfnPresentCb

pfnPresentCbDXGI