PFND3D10DDI_CLEARDEPTHSTENCILVIEW回调函数 (d3d10umddi.h)
ClearDepthStencilView 函数清除指定的当前绑定深度模具视图。
语法
PFND3D10DDI_CLEARDEPTHSTENCILVIEW Pfnd3d10ddiCleardepthstencilview;
void Pfnd3d10ddiCleardepthstencilview(
D3D10DDI_HDEVICE unnamedParam1,
D3D10DDI_HDEPTHSTENCILVIEW unnamedParam2,
UINT unnamedParam3,
FLOAT unnamedParam4,
UINT8 unnamedParam5
)
{...}
参数
unnamedParam1
hDevice [in]
显示设备的句柄 (图形上下文) 。
unnamedParam2
hDepthStencilView [in]
要清除的深度模具视图的句柄。
unnamedParam3
模具 [in]
要设置模具的无符号 8 位整数值。
unnamedParam4
深度 [in]
要设置深度的单精度浮点向量。
unnamedParam5
Flags [in]
一个 值，该值指定要影响缓冲区的哪些部分。 此参数必须设置为D3D10_DDI_CLEAR_FLAG枚举中的以下值之一。
| 值 | 含义 |
|---|---|
| D3D10_DDI_CLEAR_DEPTH (0x01L) | Z) (深度值固定到当前绑定到槽零的视口的 ZNear 和 ZFar 范围，方法是使用 Microsoft Direct3D。 之后，再次使用 Direct3D 将 Z 固定到当前绑定深度模具视图的可表示范围。 |
| D3D10_DDI_CLEAR_STENCIL (0x02L) | 将清除模具值。 |
返回值
无
备注
驱动程序可以使用 pfnSetErrorCb 回调函数来设置错误代码。
浮点规则适用于 ClearDepthStencilView 函数。
驱动程序不应遇到任何错误，D3DDDIERR_DEVICEREMOVED除外。 因此，如果驱动程序在调用 pfnSetErrorCb 函数时传递除D3DDDIERR_DEVICEREMOVED以外的任何错误，则 Direct3D 运行时将确定错误严重。 即使删除了设备，驱动程序也不需要返回D3DDDIERR_DEVICEREMOVED;但是，如果设备移除干扰了 ClearDepthStencilView (通常不应) 发生的操作，驱动程序可能会返回D3DDDIERR_DEVICEREMOVED。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | 在 Windows Vista 和更高版本的 Windows 操作系统中可用。 |
| 目标平台 | 桌面 |
| 标头 | d3d10umddi.h (包括 D3d10umddi.h) |