WDDM Sync Test

This automated test verifies that user-mode drivers properly synchronize the CPU and GPU when resources are used by the CPU and GPU.

This test verifies that user-mode display drivers expose correct locking semantics. In particular, there are two situations in which user-mode drivers must flush command buffers to kernel mode before returning from a Lock() call:

  • When a resource that is the target of a pending GPU write operation is locked

  • When a resource that is the source of a pending GPU read operation is locked

The test creates video memory resources and instructs the user-mode driver to program the GPU to read from or write to these resources. The test then locks the resources and reads their contents with the CPU. The test verifies that the data read by the CPU indicates that the Lock DDI is blocked until the GPU finishes processing all commands that reference the resources.

This topic applies to the following test jobs:

  • WDDM Sync Test

  • WDDM Sync Test (WoW64)

Test details

   
Specifications
  • Device.Graphics.WDDM.DisplayRender.Base
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

Sync.exe monitor:1

Runs both the WDDM Sync Test test job and the WDDM Sync Test (WoW64) test job.

 

File list

File Location

Configdisplay.exe

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

Sync.exe

<[testbinroot]>\nttest\

TDRWatch.exe

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

 

Parameters

Parameter name Parameter description
MONITOR Index of display output to target with test
LLU_NetAccessOnly LLU Name of net user
ConfigDisplayCommandLine Custom Command Line for ConfigDisplay. Default: logo
TDRArgs /get or /set