This topic has not yet been rated - Rate this topic

RenderCapability.Tier Property

Updated: October 2010

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.
Note Note

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.

Date

History

Reason

October 2010

Updated information for the .NET Framework 4 and rendering tier 2.

Customer feedback.

Did you find this helpful?
(1500 characters remaining)
Community Content Add
Annotations FAQ
RDP to VMWare Workstation host
$0$0 $0 $0 $0When I am using RDP to remote control a VMWare Workstation host, and I run a WPF Application inside a VM, the WPF application doesn’t display. The window opens, and you see the frame of your windows, but the inside is just blank or a white/gray box. None of the WPF Controls are visible. $0 $0 $0 $0If I go chromeless the issue is worse because nothing shows up at all.$0 http://www.rhyous.com/2010/12/20/vmware-rdp-mstsc-wpf-and-disablehwacceleration/$0 $0I use this property in C# to get the Tier.$0 $0 $0public int SupportedRenderingTier { get { return (RenderCapability.Tier >> 16); } }$0 $0 $0When I debug, this value is 2. So even though VMWare cannot seem to do any rendering, this value is 2.$0 $0Steps to duplicate are easy.$0 $0 $0 $0Install VMWare Workstation on Windows (I used WIndows 7 64 bit). $0 $0Create a new virtual machine and install any Windows OS.$0 $0Note: I used either WIndows 7 64 bit or 2008 R2. $0 $0Remote Desktop to the VMWare Host. $0 $0While in RDP, run a WPF app inside the Virtual Machine.$0 $0 $0 $0So for some reason the RenderCapability.Tier says 2, when it is not working.$0