D3D9 覆盖层 - CreateDeviceEx

此自动测试执行多个针对 IDirect3D9Ex::CreateDeviceEx 的测试用例。它使用不同大小的后端缓冲区和格式，并使用和不使用无效标志和多重采样。它还使用有效和无效的显示模式，包括旋转模式。

测试详细信息


规范	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

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

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

此外，此测试还需要以下先决条件：

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

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

测试使用有效和无效参数调用 CreateDeviceEx。它将尝试检查最大覆盖层大小，以及报告为受驱动程序支持的最小覆盖层大小。测试不会向屏幕显示任何帧，它只会在测试用例上进行迭代，并生成 PASS 或 FAIL 结果。

如果驱动程序未公开 D3DCAPS_OVERLAY，或者在 D3D 设备创建期间不支持后台缓冲区格式或模式，则测试可能会返回 SKIP。

此测试运行以下测试作业

CreateDeviceEx：

如果支持非 RGB 覆盖层，则验证是否成功创建非 RGB 后台缓冲区。
验证交换效果是否全屏失败并成功窗口化。
验证当使用 D3D9OverlayExtended 以外的接口时交换效果是否失败。
验证多重采样是否失败。
一个测试用例，其中，一个进程创建了 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（失败还是成功）。

ResetEx 期间的 CreateDeviceEx：

验证在设备的 ResetEx 期间指定了其他 D3DPRESENTFLAG 时，是否会成功重写具有指定 D3DPRESENTFLAG 的 CreateDeviceEx。

警告

使用不受支持的 D3DPRESENTFLAG 验证 ResetEx（失败还是成功）。

命令选项	说明
D3D9OverlayTest CreateDeviceEx -whql -logclean	此命令运行 D3D9 覆盖 - CreateDeviceEx 测试作业。如果未使用任何选项，则测试将枚举除某些极端无效参数测试用例以外的所有测试用例。
TestCasePriority:[0, 1, 2]	指定要运行的测试用例的优先级。如果设置为 0，则会运行构建验证测试 (BVT) 级别测试用例；如果设置为 1 或 2，则会运行更为严格的测试用例。
LogLevel[0, 1, 2]	此测试能够记录非常详细的日志。默认情况下，级别设置为 0，但级别 1 将为每个测试用例收集更多日志记录信息，包括许多流状态/blt 状态集。级别 2 将收集所有调整后的流状态和 blt 状态，以及任何配置信息。

D3D9OverlayTest CreateDeviceEx -whql -logclean

此命令运行 D3D9 覆盖 - CreateDeviceEx 测试作业。

如果未使用任何选项，则测试将枚举除某些极端无效参数测试用例以外的所有测试用例。

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 的自定义命令行。默认值：徽标