WGF11 Resource Access

  • Article

This automated test verifies D3D graphics driver/hardware conformance for resource copying functions and the integrity of the data manipulated. There are also groups for D3D10.1 features that allow copying of compressed textures to structured formats and copying of multisample resources.

This topic applies to the following test jobs:

  • WGF11 Resource Access

  • WGF11 Resource Access (WoW64)

  • WGF11 Resource Access FL9.3

  • WGF11 Resource Access FL9.3 (WoW64)

Test details

   
Specifications
  • Device.Graphics.AdapterRender.D3D111Core.D3D111CorePrimary
  • Device.Graphics.AdapterRender.D3D11Core.D3D11CorePrimary
  • Device.Graphics.AdapterRender.D3D101Core.D3D101CorePrimary
  • Device.Graphics.AdapterRender.D3D10Core.D3D10CorePrimary
  • Device.Graphics.AdapterRender.D3D101WDDM12.D3D101v12Primary
  • Device.Graphics.AdapterRender.D3D10WDDM12.D3D10v12Primary
  • Device.Graphics.AdapterRender.D3D11WDDM12.D3D11v12Primary
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) 20
Category Compatibility
Timeout (in minutes) 1200
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. 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 feature level is lower than the one required to test a particular feature (10.1 for CopyMultisample/CopyCompressed). The test might return BLOCKED if there is an uncaught exception (framework catches it at the end and logs it). To review test details, review the test log from the DTM Studio.

More information

You can access and modify the contents of resources through four functions: CopyResource(), CopySubresourceRegion(), UpdateSubresource(), and Map().

  • Test behavior when specifying regions that are 1 pixel in size and other special cases.

  • Ensure consistent data when copying from mip (progressively smaller and less detailed versions of the texture) and array slices.

  • Make sure that only specified data is changed and other subresources or regions remain untouched.

  • Test behavior with special and compressed formats.

  • Watch for CopyResource() and related functions that affect pipeline statistics. You can choose to use the rendering pipeline to "emulate" copy functionality, but the specification states that copy functions cannot affect pipeline statistics.

CopyMultisample

Tests support for the D3D10.1 feature of copy multisample resources.

  • Varies the number of samples used.

  • Ensures a unique value in each sample location.

  • Verifies that this is preserved on copy on the destination resource.

CopyCompressed

Verifies support for copying of compressed textures to structured formats which was added in D3D10.1. The compatible structured format (i.e. traditional 3-4 color channels) for each compressed texture is tested to make sure the data in the original texture is preserved on copy. No conversion should take place. This is a bit-for-bit copy. Roundtrip copy (structured->compressed) is also tested and should also be bit-for-bit accurate.

Command syntax

Command option Description

Wgf11resourceaccess

Runs the test 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\

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