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 函数时，指向 D3DDDIARG_CLEAR 结构的指针在 pData 参数中传递。 Microsoft Direct3D 运行时在调用用户模式显示驱动程序的 Clear 函数时将信息传递给 NumRect 和 pRect 参数，以指定驱动程序应清除的缓冲区的矩形区域。

要求

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

另请参阅

Clear