Share via

Update Surface

  • Article

This automated test verifies correct implementation of the driver functionality that underlies the IDirect3DDevice9::UpdateSurface method.

The test uses the IDirect3D9::CheckDeviceFormat method to determine the combinations of formats and surface types that the driver supports.

For all valid surface-type combinations, the test performs a comprehensive set of UpdateSurface operations. These operations include full surface and subrect copies, with and without translation.

The test accomplishes automatic verification by rendering both the destination surface and a reference surface and comparing the rendered images. The test uses the LoadSurfaceFromSurface function in Microsoft® Direct3D® 9 to prepare reference images.

This topic applies to the following test jobs:

  • Update Surface

  • Update Surface (WoW64)

Test details

   
Specifications
  • Device.Graphics.AdapterRender.MinimumDirectXLevel
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) 5
Category Compatibility
Timeout (in minutes) 300
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.

More information

Command syntax

Command option Description

Updatesurface.exe -M:1 -dx9 -whql -logclean

Runs the Update Surface test job.

Updatesurface.exe -M:1 -whql -logclean

Runs the Update Surface (WoW64) test job.

Note

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

 

File list

File Location

Configdisplay.exe

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

D3d10ref.dll

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

D3d11ref.dll

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

D3dcompiler_test.dll

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

D3dref.dll

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

D3dref8.dll

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

D3dref9.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\

D3dx8d.dll

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

D3dx9_TEST.dll

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

Fpstate.dll

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

TDRWatch.exe

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

Updatesurface.exe

<[testbinroot]>\nttest\

Vbswap.x

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

 

Parameters

Parameter name Parameter description
MONITOR Index of display output to target with test
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