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 发送到图形处理器之前确定目标。
出现许多资源时, hDstResource 将为 NULL,并且驱动程序只能转换最后一个源资源句柄以用于 pfnPresentCb 函数。
[in] DstSubResourceIndex
从零开始的索引到目标资源中, hDstResource 成员指定的句柄。 DstSubResourceIndex 索引指示要显示的子资源或图面。
[in] pDXGIContext
DXGI 上下文的句柄。 此句柄对驱动程序不透明。 当驱动程序调用 pfnPresentCbDXGIGIXGI 函数时,驱动程序必须将此成员中的句柄作为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 |
Header | dxgiddi.h (包括 D3d10umddi.h) |