GetRenderTargetData - Mip 纹理和立体纹理

此自动测试验证能否使用 IDirect3DDevice9::GetRenderTargetData 方法 (Microsoft Direct3D 9) 提取呈现器目标 Mipmap 和 Cubemap 的内容。

测试首先创建源和目标图面。 测试将循环使用各种图面格式和使用规范。 如果无法创建任何一个图面,则会跳过该配置。 创建图面后,呈现器目标图面使用纹理化四面体填充。 接下来,使用 GetRenderTargetData 方法将源复制到目标,并执行图面比较来验证两个图面内容是否相同。

本主题适用于以下测试作业:

  • GetRenderTargetData - Mip 纹理和立体纹理

  • GetRenderTargetData - Mip 纹理和立体纹理 (WoW64)

测试详细信息

   
规范
  • Device.Graphics.AdapterRender.MinimumDirectXLevel
平台
  • Windows 10,客户端版本 (x86)
  • Windows 10,客户端版本 (x64)
  • Windows Server 2016 (x64)
  • Windows 10,客户端版本 (Arm64)
支持的版本
  • Windows 10
  • Windows 10 版本 1511
  • Windows 10 版本 1607
  • Windows 10 版本 1703
  • Windows 10 版本 1709
  • Windows 10 版本 1803
  • Windows 10 版本 1809
  • Windows 10 版本 1903
  • Windows 10 的下一次更新
预计运行时间(以分钟为单位) 2
类别 兼容性
超时(以分钟为单位) 120
需要重启 false
需要特殊配置 false
类型 automatic

 

其他文档

此功能区域中的测试可能会有其他文档,包括先决条件、设置和故障排除信息,这些内容可在以下主题中找到:

运行测试

在运行测试之前,请按照如下测试要求中所述完成测试设置:图形适配器或芯片组测试先决条件

此外,此测试需要以下软件和硬件。

  • Microsoft DirectX® 9.0 或更高版本

故障排除

有关 HLK 测试失败的常规故障排除,请参阅排查 Windows HLK 测试失败问题

有关故障排除信息,请参阅排查 Device.Graphics 测试问题

更多信息

此测试对 IDirect3DDevice9::GetRenderTargetData 方法的功能和操作规范进行验证。 使用 GetRenderTargetData 方法,可以将呈现器目标图面的内容复制到系统内存图面。 要使此复制成功,必须满足对源和目标图面的若干限制。

  • 源图面必须是常规呈现器目标图面,或特定级别的呈现器目标纹理(MIP 贴图或立方体纹理)。

  • 源必须是 POOL_DEFAULT 和 D3DMULTISAMPLE_NONE。

  • 目标图面必须是离屏普通图面或使用 POOL_SYSTEMMEM 创建的纹理(MIP 贴图或立方体)。

  • 源和目标图面必须具有相同的维度和格式。

下表显示了此测试的图面组合矩阵以及用于选择图面的类型的命令选项。

Surface 离屏普通 MIP 贴图纹理 立方体纹理

后台缓冲区

-grtdbb

-grtdbbt

-grtdbbct

呈现器目标

-grtdrt

-grtdrtt

-grtdrtct

MIP 贴图纹理

-grtdts

-grtdtt

-grtdtct

立方体纹理

-grtdcts

-grtdctt

-grtdctct

 

命令语法

命令选项 说明

Getrendertargetdata.exe -grtdts -grtdtt -grtdtct -grtdcts -grtdctt -grtdctct -M:1 -dx9 -whql -logclean

运行测试作业,包括特定图面的选项。 有关使用哪种选项的详细信息,请参阅本主题前面的表。

注意

   有关此测试二进制文件的命令行帮助,请键入 /h。

 

文件列表

文件 位置

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\

 

参数

参数名称 参数说明
MONITOR 以测试为目标的显示输出索引
MODIFIEDCMDLINE 测试可执行文件的其他命令行参数
LLU_NetAccessOnly 网络用户的 LLU 名称
ConfigDisplayCommandLine ConfigDisplay 的自定义命令行。 默认值:徽标
TDRArgs /get 或 /set