GetRenderTargetData - Mip Texture and Cube Texture
This automated test verifies that you can use the IDirect3DDevice9::GetRenderTargetData method (Microsoft Direct3D 9) to extract the contents of Render Target Mipmaps and Cubemaps.
The test first creates the source and destination surfaces. The test cycles through various surface formats and usage specifications. If either surface cannot be created, that configuration is skipped. After the surfaces are created, the render-target surface is filled with a textured quad. Next, the source is copied to the destination with the GetRenderTargetData method and a surface comparison is performed to verify that the two surface contents are the same.
This topic applies to the following test jobs:
GetRenderTargetData - Mip Texture and Cube Texture
GetRenderTargetData - Mip Texture and Cube Texture (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 |
~2 minutes |
Categories |
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.
In addition, this test requires the following software and hardware.
- Microsoft DirectX® 9.0 or later
Troubleshooting
For troubleshooting information, see Troubleshooting Device.Graphics Testing.
More information
This test validates the functional and operational specifications for the IDirect3DDevice9::GetRenderTargetData method. The GetRenderTargetData method provides a way to copy the contents of a render-target surface to a system-memory surface. There are several restrictions on the source and destination surfaces that you must meet for this copy to succeed.
The source surface must be a regular render-target surface or a specific level of a render-target texture (MIP map or cube texture).
The source must be POOL_DEFAULT and D3DMULTISAMPLE_NONE.
The destination surface must be either an off-screen plain surface or a texture (MIP map or cube) created with POOL_SYSTEMMEM.
The source and destination surfaces must be the same dimension and format.
The following table shows the matrix of surface combinations that this test and the command options that are used to select the type of surface.
| Surface | Offscreen plain | MIP-map texture | Cube texture |
|---|---|---|---|
Back buffer |
-grtdbb |
-grtdbbt |
-grtdbbct |
Render target |
-grtdrt |
-grtdrtt |
-grtdrtct |
MIP-map texture |
-grtdts |
-grtdtt |
-grtdtct |
Cube texture |
-grtdcts |
-grtdctt |
-grtdctct |
Command syntax
| Command option | Description |
|---|---|
Getrendertargetdata.exe -grtdts -grtdtt -grtdtct -grtdcts -grtdctt -grtdctct -M:1 -dx9 -whql -logclean |
Runs the test job, including options for specific surfaces. For more information about which option to use, see the table earlier in this topic. |
Note
For command line help for this test binary, type /h.
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\ |
D3dref.dll |
<[testbinroot]>\nttest\windowstest\graphics\d3d\support |
D3dref8.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\ |
D3dx8d.dll |
<[testbinroot]>\nttest\windowstest\graphics\d3d\support\ |
D3dx9_TEST.dll |
<[testbinroot]>\nttest\windowstest\graphics\d3d\support\ |
Fpstate.dll |
<[testbinroot]>\nttest\windowstest\graphics\d3d\utility\ |
Getrendertargetdata.exe |
<[testbinroot]>\nttest\ |
Modechange.exe |
<[testbinroot]>\nttest\windowstest\graphics\d3d\utility\ |
TDRWatch.exe |
<[testbinroot]>\nttest\windowstest\graphics\ |
Vbswap.x |
<[testbinroot]>\nttest\windowstest\graphics\d3d\conf\ |