IDirect3DDevice9::SetDepthStencilSurface 方法 (d3d9helper.h)
设置深度模具图面。
语法
HRESULT SetDepthStencilSurface(
[in] IDirect3DSurface9 *pNewZStencil
);
参数
[in] pNewZStencil
类型: IDirect3DSurface9*
指向表示深度模具图面 的 IDirect3DSurface9 接口的指针的地址。 将其设置为 NULL 会禁用深度模具操作。
返回值
类型: HRESULT
如果该方法成功,则返回值D3D_OK。 如果 pZStencilSurface 不是 NULL,则当模具图面无效时,返回值D3DERR_INVALIDCALL。
注解
使用此方法的限制包括:
- 对于呈现目标和深度模具图面,多重采样类型必须相同。
- 格式必须与呈现目标和深度模具图面兼容。 请参阅 IDirect3D9::CheckDepthStencilMatch。
- 深度模具图面的大小必须大于或等于呈现器目标的大小。
立方体纹理与其他表面的不同之处在于,它们是图面的集合。 若要使用立方体纹理调用 IDirect3DDevice9::SetDepthStencilSurface ,必须使用 IDirect3DCubeTexture9::GetCubeMapSurface 选择单个人脸,并将生成的表面传递给 IDirect3DDevice9::SetDepthStencilSurface。
要求
要求 | 值 |
---|---|
目标平台 | Windows |
标头 | d3d9helper.h (包括 D3D9.h) |
Library | D3D9.lib |