Método IDirect3DDevice9::SetDepthStencilSurface (d3d9helper.h)

Establece la superficie de galería de símbolos de profundidad.

Sintaxis

HRESULT SetDepthStencilSurface(
  [in] IDirect3DSurface9 *pNewZStencil
);

Parámetros

[in] pNewZStencil

Tipo: IDirect3DSurface9*

Dirección de un puntero a una interfaz IDirect3DSurface9 que representa la superficie de galería de símbolos de profundidad. Si se establece en NULL , se deshabilita la operación de galería de símbolos de profundidad.

Valor devuelto

Tipo: HRESULT

Si el método se realiza correctamente, el valor devuelto es D3D_OK. Si pZStencilSurface es distinto de NULL, el valor devuelto se D3DERR_INVALIDCALL cuando la superficie de la galería de símbolos no es válida.

Comentarios

Entre las restricciones para usar este método se incluyen las siguientes:

• El tipo multisample debe ser el mismo para el destino de representación y la superficie de galería de símbolos de profundidad.
• Los formatos deben ser compatibles con el destino de representación y la superficie de galería de símbolos de profundidad. Consulte IDirect3D9::CheckDepthStencilMatch.
• El tamaño de la superficie de galería de símbolos de profundidad debe ser mayor o igual que el tamaño del destino de representación.

Estas restricciones solo se validan cuando se usa el tiempo de ejecución de depuración cuando se llama a cualquiera de los métodos Draw de IDirect3DDevice9.

Las texturas de cubo difieren de otras superficies en que son colecciones de superficies. Para llamar a IDirect3DDevice9::SetDepthStencilSurface con una textura de cubo, debe seleccionar una cara individual con IDirect3DCubeTexture9::GetCubeMapSurface y pasar la superficie resultante a IDirect3DDevice9::SetDepthStencilSurface.

Requisitos

Requisito	Value
Plataforma de destino	Windows
Encabezado	d3d9helper.h (incluya D3D9.h)
Library	D3D9.lib

Consulte también

IDirect3DDevice9

IDirect3DDevice9::GetDepthStencilSurface