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