WGF11 Render Targets

  • Article

This automated 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.

This topic applies to the following test jobs:

  • WGF11 Render Targets

  • WGF11 Render Targets (WoW64)

Test details

   
Specifications
  • Device.Graphics.AdapterRender.D3D111Core.D3D111CorePrimary
  • Device.Graphics.AdapterRender.D3D11Core.D3D11CorePrimary
  • Device.Graphics.AdapterRender.D3D101Core.D3D101CorePrimary
  • Device.Graphics.AdapterRender.D3D10Core.D3D10CorePrimary
Platforms
  • Windows 10, client editions (x86)
  • Windows 10, client editions (x64)
  • Windows Server 2016 (x64)
  • Windows 10, client editions (Arm64)
Supported Releases
  • Windows 10
  • Windows 10, version 1511
  • Windows 10, version 1607
  • Windows 10, version 1703
  • Windows 10, version 1709
  • Windows 10, version 1803
  • Windows 10, version 1809
  • Windows 10, version 1903
  • Next update to Windows 10
Expected run time (in minutes) 2
Category Compatibility
Timeout (in minutes) 120
Requires reboot false
Requires special configuration false
Type automatic

 

Additional documentation

Tests in this feature area might have additional documentation, including prerequisites, setup, and troubleshooting information, that can be found in the following topic(s):

Running the test

Before you run the test, complete the test setup as described in the test requirements: Graphic Adapter or Chipset Testing Prerequisites.

Troubleshooting

For generic troubleshooting of HLK test failures, see Troubleshooting Windows HLK Test Failures.

For troubleshooting information, see Troubleshooting Device.Graphics Testing.

All test cases return PASS or FAIL. To review test details, review the test log from the DTM Studio 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).

More information

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, and so on.

  • 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, and so on), and using special floating point values as the clear value (INF, NaN, and so on).

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.

Command syntax

Command option Description

Wgf11rendertargets

Rusn the terst jobs. Without any options, the test enumerates devices.

-FeatureLevel:XX.X

Sets the feature level, where XX.X is the Feature Level the test will run at: 10.0, 10.1, or 11.0.

Note

   For command line help for this test binary, type /?.

 

File list

File Location

Configdisplay.exe

<[testbinroot]>\nttest\windowstest\tools\

D3d11_1sdklayers.dll

<[testbinroot]>\nttest\windowstest\graphics\d3d\support\

D3d11ref.dll

<[testbinroot]>\nttest\windowstest\graphics\d3d\support\

D3d11sdklayers.dll

<[testbinroot]>\nttest\windowstest\graphics\d3d\support\

D3dcompiler_test.dll

<[testbinroot]>\nttest\windowstest\graphics\d3d\support

D3dx10_test.dll

<[testbinroot]>\nttest\windowstest\graphics\d3d\support\

d3dx11_test.dll

<[testbinroot]>\nttest\windowstest\graphics\d3d\support\

TDRWatch.exe

<[testbinroot]>\nttest\windowstest\graphics\

wgf11rendertargets.exe

<[testbinroot]>\nttest\windowstest\graphics\d3d\conf

 

Parameters

Parameter name Parameter description
MODIFIEDCMDLINE Additional command line arguments for test executable
LLU_NetAccessOnly LLU Name of net user
ConfigDisplayCommandLine Custom Command Line for ConfigDisplay. Default: logo
TDRArgs /get or /set