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

标志 [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。 因此,如果驱动程序通过除D3DDDIERR_DEVICEREMOVED以外的任何错误,在调用 pfnSetErrorCb 函数时,Direct3D 运行时将确定错误至关重要。 即使设备已删除,驱动程序也不需要返回D3DDDIERR_DEVICEREMOVED;但是,如果设备删除干扰了 ClearDepthStencilView(通常不应发生),驱动程序可以返回D3DDDIERR_DEVICEREMOVED。

要求

要求 价值
最低支持的客户端 在 Windows Vista 和更高版本的 Windows作系统中可用。
目标平台 桌面
标头 d3d10umddi.h (包括 D3d10umddi.h)

另请参阅

D3D10DDI_DEVICEFUNCS

pfnSetErrorCb