GraphicsAdapter.CheckDepthStencilMatch Method

Tests whether a depth stencil format is compatible with a render target format in a particular display mode.

Namespace: Microsoft.Xna.Framework.Graphics
Assembly: Microsoft.Xna.Framework (in microsoft.xna.framework.dll)

Syntax

public bool CheckDepthStencilMatch (
         DeviceType deviceType,
         SurfaceFormat adapterFormat,
         SurfaceFormat renderTargetFormat,
         DepthFormat depthStencilFormat
)

Parameters

• deviceType
  The device type.
• adapterFormat
  The format of the display mode into which the adapter will be placed.
• renderTargetFormat
  The format of the render-target surface to be tested.
• depthStencilFormat
  The format of the depth stencil surface to be tested.

Return Value

true if the format is compatible; false otherwise.

Exceptions

Exception type	Condition
DeviceNotSupportedException	(Xbox 360) Hardware is the only device type supported on this platform.

Remarks

CheckDepthStencilMatch enables applications to work with hardware that requires that certain depth formats work only with certain render target formats.

Note

The following surface formats are not supported on the Xbox 360 platform for any ResourceType, including textures:

• SurfaceFormat.Bgr24
• SurfaceFormat.Bgra2338
• SurfaceFormat.Bgr233
• SurfaceFormat.NormalizedByte2Computed
• SurfaceFormat.LuminanceAlpha8
• SurfaceFormat.Palette8
• SurfaceFormat.PaletteAlpha16
• SurfaceFormat.Multi2Bgra32
• SurfaceFormat.Depth15Stencil1
• SurfaceFormat.Depth24Stencil4

See Also

Concepts

Xbox 360 Surface Formats

Reference

GraphicsAdapter Class
GraphicsAdapter Members
Microsoft.Xna.Framework.Graphics Namespace

Platforms

Xbox 360, Windows XP SP2, Windows Vista