WDDM Rotate

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.

Overview

The WDDM Rotate test executes a number of scenarios to verify that rotation of the contents of the monitors is handled correctly by the display driver and the operating system.

Details

The WDDM Rotate test executes a number of rotation scenarios to verify that the content that is displayed on the screen to the user is shown correctly in a rotated environment. Rotation of the screen is tested at various resolutions and orientations for each test (it is possible to specify command line options to target a certain mode for reproducing issues). The different tests are detailed below:

• WinGdi
  This test draws a known image to an internal buffer, and then uses BitBlt to copy the contents of the internal buffer into the shadow buffer of the CDD driver. The test then verifies the contents of the CDD primary buffer against what the test expects to be in the primary buffer. The test surface runs in a window for this test. If the caller opts to save a copy of the buffers that are used in the test, the copy will be saved as a file called GdiCdd<Width>x<Height>x<Bpp>r<Rotation>.bmp i.e. GdiCdd1280x1024x32r180.bmp.

• WinCdd
  This test fills the CDD primary buffer with solid colors by using the ColorFill and Present method, setting the rotation bit to 1 in the D3DKMT_PRESENTFLAGS structure. This requires the driver to perform the rotation. The test then verifies that the contents of the CDD primary and CDD shadow buffers match as expected. This test runs in a window on the desktop, rather than running in a full screen. If the caller opts to save a copy of the image that is captured to compare during the test, the copy will be saved in the working directory as CddGdi<Width>x<Height>x<Bpp>r<Rotation>.bmp.

• WinD3D
  This test draws data to the render target by using the D3D DrawPrimitive method. Data from the render target is then compared to data in the CDD primary buffer to verify that the contents are as expected, taking the rotation factor into account. This test runs inside a window on the desktop.

• D3D
  This test executes a full screen version of the WinD3D test, so that the whole screen area is used to test rather than just a windowed portion.

• FullScreen
  This test executes the WinCdd test in full screen mode, so that the whole screen area is used for testing rather than just a windowed portion. If the caller chooses to save a copy of the image comparison buffer that is used in the test, the copy will be saved in the working directory as FSColorFill<Width>x<Height>x<Bpp>r<Rotation>.bmp.

There are a number of command line parameters that the test uses. Most of these are optional and can be set to reproduce a specific issue, for example, set the width, height, BPP, monitor, and rotation. If the command line parameters relating to display mode properties are not set, the test executes its default set of parameters and runs through a set of predefined modes.

Run Time:

Log File:

System Restart Required:

Test Category:

Supported operating systems for Logo or Signature testing:

• Windows 7

• Windows Server 2008 R2

Requirements

Software Requirements

The test tool requires the following software:

• Windows Vista
• Software components included with the device that is being tested.

Hardware Requirements

• 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

• x86
• x64

Running WDDM Rotate

Command Syntax

Build date: 9/14/2012