Stretch Rect

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

The Stretch Rect test uses the IDirect3D9::CheckDeviceFormat method to determine the combinations of formats and surface types that the driver supports. It also uses the IDirect3D9::CheckDeviceFormatConversion method to determine the color-conversion operations that the driver supports.

For all valid surface-type combinations, the test performs a comprehensive set of StretchRect operations. These operations include those that involve stretching, color conversion, and copies to or from a subset rectangle (subrect). In these test cases, the source surface may be a texture surface (RT or non-RT), an off-screen render target, or an off-screen plain surface. The destination must be a render target or an RT texture surface.

Under D3D9L, the test also considers a more comprehensive set of source and destination surface-type combinations: Each surface may be a non-RT texture surface, an RT texture surface, an off-screen RT, or an off-screen plain surface. All sixteen combinations are tested. However, in compliance with D3D9L specifications, the StretchRect operations are limited to those that involve only full-surface copies without stretching or color conversion.

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 D3DX9 to prepare reference images.

This topic applies to the following test jobs:

  • Stretch Rect

  • Stretch Rect (WoW64)

Test details

Associated requirements

Device.Graphics.AdapterRender.MinimumDirectXLevel

See the device hardware requirements.

Platforms

Windows 7 (x64) Windows 7 (x86) Windows RT (ARM-based) Windows 8 (x64) Windows 8 (x86) Windows Server 2012 (x64) Windows Server 2008 R2 (x64) Windows RT 8.1 Windows 8.1 x64 Windows 8.1 x86 Windows Server 2012 R2

Expected run time

~45 minutes

Categories

Basic Certification Functional

Type

Automated

 

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 troubleshooting information, see Troubleshooting Device.Graphics Testing.

More information

Command syntax

Command option Description

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

Runs the Stretch Rect test job.

stretchrect.exe -M:1 -whql -logclean

Runs the Stretch Rect (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\

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\

Fpstate.dll

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

Modechange.exe

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

Stretchrect.exe

<[testbinroot]>\nttest\

TDRWatch.exe

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

Vbswap.x

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

 

 

 

Send comments about this topic to Microsoft