WGF11 Render Targets
Note This content applies to the Windows Logo Kit (WLK). For the latest information using the new Windows Hardware Certification Kit (HCK), see Windows HCK User's Guide on the Windows Hardware Dev Center.
Type: Automated Test
Overview
The WGF11RenderTargets test verifies D3D graphics driver/hardware conformance for render target features and RenderTargetViews. It also verifies driver support for render target clearing and swap chains.
Details
RenderTargets (tests mainly RenderTargetViews)
Rather than rendering to the backbuffer that is presented on the screen, you can draw to a render target resource. This is typically used in environment mapping techniques or in techniques where multiple passes are involved where the render target texture is used as input in another pass.
Tests cycles through all formats capable of being used as a render target. No conversion takes place, but results must be within 1-ULP (Unit Least Precision) of expected result (per component).
Three types of source data are used: tiles, gradients, and stripes. Each data type is parameterized, such as gradient colors, tile and stripe size, etc.
Depending on the resource type (all five types are tested), the test cycles through different values for height, width, and depth. This includes non-square and non-pow-2 values.
MRT (Multiple Render Targets) are tested, and multiple mip-levels and array slices are targeted.
Hits all render target slots throughout the test run.
Renders to VB, IB, and shader resource (verify in subsequent Draw() call).
Renders to texture cube (and sub mips) by creating a Texture2DArray render target view.
Clear
Tests clearing of the bound render target view through the ClearRenderTargetView D3D API. This includes testing of the various resource types (1D, 2D, etc.), and using special floating point values as the clear value (INF, NaN, etc.).
SwapChain
Tests rendering to the backbuffer and presenting using various swap chain creation parameters, including format. Also tests back buffer casting, which is new to D3D11. This allows creating a render target view of a format that is not in the same typeless family as the resource's format.
Run Time: 40 minutes
Log File: WGF11RenderTargets.xml
System Restart Required: No
Test Category: Display Adapter and Chipset
Supported operating systems for Logo or Signature testing:
Windows 7
Windows Server 2008 R2
Windows Vista
Windows Server 2008
Program: wgf11rendertargets.exe.
Requirements
Software Requirements
The test tool requires the following software:
Supported operating system (see list above)
Software components included with the device that is being tested
Hardware Requirements
The test tool requires the following hardware:
Device to be tested
Computer that meets the minimum software requirements
Windows keyboard
Two-button pointing device
Color display monitor capable of at least 1024 by 768 resolution, 32-bits per pixel, 60 Hz
Hard drive with a minimum of 20 GB available on partition C:
Processor
The test tool runs on the following processor architectures:
x86
x64
Running the Test
All test cases return PASS or FAIL. Review the test results in the log file for specific details about failures.
The test might return SKIP if a format is not supported by the device, or if the device does not support backbuffer casting for a particular format (in the SwapChain test group).
The test might return BLOCKED if there is an uncaught exception (framework catches it at the end and logs it).
Command Syntax
Command option | Description |
---|---|
wgf11rendertargets.exe |
Without any options, the test enumerates devices. |
-FeatureLevel:XX.X |
Where XX.X is the Feature Level the test will run at, 10.0, 10.1, or 11.0 |
Code Tour
File Manifest
File | Location |
---|---|
wgf11rendertargets.exe |
[testbinroot]\nttest\windowstest\graphics\d3d\conf |
Test Assertions
Test enforcing Windows Logo Requirement: Graphics-0076
Build date: 9/14/2012