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 (0x000000001l) | 驱动程序应将上下文的呈现目标清除为 FillColor 成员指定的颜色。 此值在 D3d8types.h 中定义。 |
| D3DCLEAR_STENCIL (0x000000004l) | 驱动程序应将上下文的模具缓冲区清除为 FillStencil 成员指定的值。 此值在 D3d8types.h 中定义。 |
| D3DCLEAR_ZBUFFER (0x000000002l) | 驱动程序应将上下文的深度缓冲区清除到 FillDepth 成员指定的深度。 此值在 D3d8types.h 中定义。 |
| D3DCLEAR_COMPUTERECTS (0x000000008l) | 如果为清除指定矩形,驱动程序应根据当前视区剪辑这些矩形。 如果未指定矩形,驱动程序应清除整个视区。 此值在 D3dhal.h 中定义。 |
[in] FillColor
驱动程序应清除上下文的呈现目标的颜色值。
[in] FillDepth
驱动程序应使用的值在上下文的深度缓冲区中设置深度。 此成员可以是 0.0 到 1.0 范围内的值。
[in] FillStencil
驱动程序应清除上下文模具缓冲区的值。 此成员可以是介于 0 到 2ⁿ-1 范围内的整数,其中 n 是模具缓冲区中的位数。
言论
在调用用户模式显示驱动程序的 Clear 函数时,pData 参数中传递指向D3DDDIARG_CLEAR结构的指针。 Microsoft Direct3D 运行时将信息传递给 NumRect,并在调用用户模式显示驱动程序的 Clear 函数时 pRect 参数,以指定驱动程序应清除的缓冲区的矩形区域。
要求
| 要求 | 价值 |
|---|---|
| 最低支持的客户端 | 在 Windows Vista 和更高版本的 Windows作系统中可用。 |
| 标头 | d3dumddi.h (包括 D3dumddi.h) |