RenderCapability.Tier Property

Reference

Definition

Namespace:: System.Windows.Media

Assembly:: PresentationCore.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

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

public:
 static property int Tier { int get(); };

public static int Tier { get; }

static member Tier : int

Public Shared ReadOnly Property Tier As Integer

Property Value

Int32

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

Examples

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);

' The rendering tier corresponds to the high-order word of the Tier property.
Dim renderingTier As Integer = (RenderCapability.Tier >> 16)

Remarks

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.

Applies to

Del via