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, 3.5, 3.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

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

Community Additions

ADD
Show:
© 2014 Microsoft