D3D9 覆盖层 - CreateAdditionalSwapChain

  • 项目

此手动测试将使用有效参数和无效参数调用 CreateAdditionalSwapChain。 它将尝试检查最大覆盖层大小，以及报告为受驱动程序支持的最小覆盖层大小。

测试详细信息

   
规范
  • Device.Graphics.WDDM11.DisplayRender.D3D9Overlay.D3D9Overlay
平台
  • 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 的下一次更新
预计运行时间（以分钟为单位） 1
类别 兼容性
超时（以分钟为单位） 60
需要重启 false
需要特殊配置 false
类型 automatic

 

其他文档

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

运行测试

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

此外，此测试还需要以下各项：

  • 支持 D3D9 并公开 D3DCAPS_OVERLAY 的设备驱动程序。

故障排除

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

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

此测试将使用有效参数和无效参数调用 CheckDeviceOverlayType。 它将尝试检查最大覆盖层大小，以及报告为受驱动程序支持的最小覆盖层大小。

如果驱动程序未公开 D3DCAPS_OVERLAY，则测试可能会返回“跳过”。 在某些情况下，如果在创建 D3D 设备期间不支持后台缓冲区格式或模式，可能会跳过。

更多信息

此测试使用 IDirect3D9ExDevice::CreateSwapChain 执行针对 IDirect3D9Ex::CreateDevice 的多个测试用例。 它使用不同的大小，包括有效和无效的显示模式、标志和覆盖层大小。 它还测试创建不同类型的交换链。

此测试运行以下测试作业：

CreateDeviceEx：

  • 如果支持非 RGB 覆盖层，则验证是否成功创建非 RGB 后台缓冲区。

  • 验证 SwapEffect 在全屏模式下是否失败并成功窗口化。

  • 验证当使用 D3D9OverlayExtended 以外的接口时 SwapEffect 是否失败。

  • 验证多重采样是否失败。

  • 一个测试用例，其中，一个进程创建了 D3D9Ex 覆盖层设备，然后另一个进程尝试创建另一个 D3D9Ex 交换链。

  • 使用 D3DPRESENTFLAG_OVERLAY_LIMITEDRGB 验证 CreateDeviceEx 在呈现期间是否成功将颜色范围 16 限制为 235（如果驱动程序支持）。 有关详细信息，请参阅下面的 PresentEx 测试用例。

  • 使用 D3DPRESENTFLAG_OVERLAY_YCbCr_BT709 验证 CreateDeviceEx 在呈现期间是否成功增加亮度和色度采样，并将 RGB 值限制在 16 到 235 之间（如果驱动程序支持）。 有关详细信息，请参阅下面的 PresentEx 测试用例。

  • 使用 D3DPRESENTFLAG_OVERLAY_YCbCr_xvYCC 验证 CreateDeviceEx 在呈现期间是否成功在 1 到 255 之间增加 RGB 颜色范围（如果驱动程序支持）。 有关详细信息，请参阅下面的 PresentEx 测试用例。

  • 使用 D3DPRESENTFLAG 验证 CreateDeviceEx 失败还是成功。

CreateAdditionalSwapChain：

  • 验证通过 CreateAdditionalSwapChain 和重置现有交换链创建额外交换链是否失败。

命令语法

命令选项 说明

D3D9OverlayTest CreateAdditionalSwapChain -whql -logclean

此命令运行 D3D9 覆盖层 - CreateAdditionalSwapChain 测试作业。 如果未使用任何选项，则测试将枚举除某些极端用例以外的所有用例。

TestCasePriority:[0, 1, 2]

指定要运行的测试用例的优先级。 如果设置为 0，则会运行构建验证测试 (BVT) 级别测试用例；如果设置为 1 或 2，则会运行更为严格的测试用例。

LogLevel[0, 1, 2]

此测试能够记录非常详细的日志。 默认情况下，级别设置为 0，但级别 1 将为每个测试用例收集更多日志记录信息，包括许多流状态/blt 状态集。 级别 2 将收集所有调整后的流状态和 blt 状态，以及任何配置信息。

注意

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

 

文件列表

文件 位置

Configdisplay.exe

<[testbinroot]>\nttest\\windowstest\tools\

D3D9OverlayTest.exe

<[testbinroot]>\nttest\windowstest\graphics\d3d\func\

TDRWatch.exe

<[testbinroot]>\nttest\windowstest\graphics\

 

参数

参数名称 参数说明
MODIFIEDCMDLINE 测试可执行文件的其他命令行参数
LLU_NetAccessOnly 网络用户的 LLU 名称
ConfigDisplayCommandLine ConfigDisplay 的自定义命令行。 默认值：徽标