Share via


Device.DepthStencilSurface Property

Gets or sets the depth stencil surface owned by the Device structure.

Namespace:  Microsoft.WindowsMobile.DirectX.Direct3D
Assembly:  Microsoft.WindowsMobile.DirectX (in Microsoft.WindowsMobile.DirectX.dll)

Syntax

'Declaration
Public ReadOnly Property DepthStencilSurface As Surface
'Usage
Dim instance As Device 
Dim value As Surface 

value = instance.DepthStencilSurface
public Surface DepthStencilSurface { get; }
public:
property Surface^ DepthStencilSurface {
    Surface^ get ();
}
public function get DepthStencilSurface () : Surface

Property Value

Type: Microsoft.WindowsMobile.DirectX.Direct3D.Surface
Returns a surface object that represents the depth stencil surface. If no depth stencil buffer is associated with the device, the return value is nulla null reference (Nothing in Visual Basic).
Setting this value to nulla null reference (Nothing in Visual Basic) disables the depth stencil operation.

Exceptions

Exception Condition
NotFoundException

The device does not have a depth stencil buffer associated with it.

InvalidCallException

The method call is invalid. For example, a parameter might have an invalid value.

Remarks

Stencil data is commonly used to mask drawing to particular screen pixels. The following restrictions apply when using this property:

  • The multisample type must be the same for the render target and the depth stencil surface.

  • The formats for the render target and depth stencil surface must be compatible. For more information, see CheckDepthStencilMatch.

  • The size of the depth stencil surface must be greater than or equal to the size of the render target.

These restrictions are validated only when using the debug runtime when any of the Device drawing methods are called.

.NET Framework Security

Platforms

Windows CE, Windows Mobile for Smartphone, Windows Mobile for Pocket PC

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Version Information

.NET Compact Framework

Supported in: 3.5, 2.0

See Also

Reference

Device Class

Device Members

Microsoft.WindowsMobile.DirectX.Direct3D Namespace