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
| Specifications |
|
| Platforms |
|
| Supported Releases |
|
| Expected run time (in minutes) | 45 |
| Category | Compatibility |
| Timeout (in minutes) | 2700 |
| 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 |
|---|---|
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\ |
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 |