Export (0) Print
Expand All

RenderCapability.Tier Property

Gets a value that indicates the rendering tier for the current thread.

Namespace:  System.Windows.Media
Assembly:  PresentationCore (in PresentationCore.dll)

public static int Tier { get; }

Property Value

Type: System.Int32
An Int32 value whose high-order word corresponds to the rendering tier for the current thread.

NoteNote

Starting in the .NET Framework 4, rendering tier 1 has been redefined to only include graphics hardware that supports DirectX 9.0 or greater. Graphics hardware that supports DirectX 7 or 8 is now defined as rendering tier 0.

The return value is one of three possible values:

Return value

Rendering tier

Notes

0x00000000

0

No graphics hardware acceleration is available for the application on the device. All graphics features use software acceleration. The DirectX version level is less than version 9.0.

0x00010000

1

Most of the graphics features of WPF will use hardware acceleration if the necessary system resources are available and have not been exhausted. This corresponds to a DirectX version that is greater than or equal to 9.0.

0x00020000

2

Most of the graphics features of WPF will use hardware acceleration provided the necessary system resources have not been exhausted. This corresponds to a DirectX version that is greater than or equal to 9.0.

The following table shows the differences in graphics hardware requirements for rendering tier 1 and rendering tier 2:

Feature

Tier 1

Tier 2

DirectX version

Must be greater than or equal to 9.0.

Must be greater than or equal to 9.0.

Video RAM

Must be greater than or equal to 60MB.

Must be greater than or equal to 120MB.

Pixel shader

Version level must greater than or equal to 2.0.

Version level must greater than or equal to 2.0.

Vertex shader

No requirement.

Version level must greater than or equal to 2.0.

Multitexture units

No requirement.

Number of units must greater than or equal to 4.

For more information on the definitions for the rendering tiers, see Graphics Rendering Tiers.

If the current thread does not have an associated Dispatcher object, one is automatically created.

The following example shows how to return the rendering tier for the current thread.

// The rendering tier corresponds to the high-order word of the Tier property. 
int renderingTier = (RenderCapability.Tier >> 16);

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1
Show:
© 2015 Microsoft