D3DDDIARG_CLEAR结构 (d3dumddi.h)

D3DDDIARG_CLEAR结构描述硬件辅助清除操作的参数。

语法

typedef struct _D3DDDIARG_CLEAR {
  [in] UINT  Flags;
  [in] UINT  FillColor;
  [in] FLOAT FillDepth;
  [in] UINT  FillStencil;
} D3DDDIARG_CLEAR;

成员

[in] Flags

一个 UINT 值,该值指定驱动程序应清除哪些缓冲区以及如何执行清除操作。 此成员可以是以下值的按位 OR。 有关详细信息,请参阅 “清除 参考”页中的“备注”部分。

含义
D3DCLEAR_TARGET (0x00000001l) 驱动程序应将上下文的呈现目标清除为 FillColor 成员指定的颜色。 此值在 D3d8types.h 中定义。
D3DCLEAR_STENCIL (0x00000004l) 驱动程序应将上下文的模具缓冲区清除到 FillStencil 成员指定的值。 此值在 D3d8types.h 中定义。
D3DCLEAR_ZBUFFER (0x00000002l) 驱动程序应将上下文的深度缓冲区清除到 FillDepth 成员指定的深度。 此值在 D3d8types.h 中定义。
D3DCLEAR_COMPUTERECTS (0x00000008l) 如果为清除指定矩形,驱动程序应针对当前视区剪辑这些矩形。 如果未指定矩形,驱动程序应清除整个视区。 此值在 D3dhal.h 中定义。

[in] FillColor

驱动程序应清除上下文的呈现目标的颜色值。

[in] FillDepth

驱动程序应用于在上下文的深度缓冲区中设置深度的值。 此成员可以是介于 0.0 到 1.0 范围内的值。

[in] FillStencil

驱动程序应清除上下文模具缓冲区的值。 此成员可以是 0 到 2ⁿ-1 范围内的整数,其中 n 是模具缓冲区中的位数。

备注

在调用用户模式显示驱动程序的 Clear 函数时,在 pData 参数中传递指向D3DDDIARG_CLEAR结构的指针。 Microsoft Direct3D 运行时在调用用户模式显示驱动程序的 Clear 函数时,将信息传递给 NumRectpRect 参数,以指定驱动程序应清除的缓冲区的矩形区域。

要求

   
最低受支持的客户端 在 Windows Vista 和更高版本的 Windows 操作系统中可用。
Header d3dumddi.h (包括 D3dumddi.h)

另请参阅

Clear