通过

GetRenderTargetData - 后台缓冲区和呈现器目标

  • 项目

此自动化测试验证 Microsoft® Direct3D® 9 中的 IDirect3DDevice9::GetRenderTargetData 方法是否可用于提取后台缓冲区和基本呈现目标的内容。

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

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

  • GetRenderTargetData - 后台缓冲区和呈现器目标

  • GetRenderTargetData - 后台缓冲区和呈现器目标 (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 的下一次更新
预计运行时间（以分钟为单位） 8
类别 兼容性
超时（以分钟为单位） 480
需要重启 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 -grtdbb -grtdbbt -grtdbbct -grtdrt -grtdrt -grtdrtt -grtdrtct -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