D3D9 覆盖层 - CheckDeviceOverlayType
此手动测试执行多个针对 IDirect3D9ExOverlayExtension::CheckDeviceOverlayType 的测试用例。 它使用不同大小的有效和无效显示模式，包括旋转模式。
测试详细信息
| 规范 |
|
| 平台 |
|
| 支持的版本 |
|
| 预计运行时间（以分钟为单位） | 1 |
| 类别 | 兼容性 |
| 超时（以分钟为单位） | 60 |
| 需要重启 | false |
| 需要特殊配置 | false |
| 类型 | automatic |
其他文档
此功能区域中的测试可能会有其他文档，包括先决条件、设置和故障排除信息，这些内容可在以下主题中找到：
运行测试
在运行测试之前，请按照如下测试要求中所述完成测试设置：图形适配器或芯片组测试先决条件。
此外，此测试需要以下各项：
- 支持 D3D9 并公开 D3DCAPS_OVERLAY 的设备驱动程序
故障排除
有关 HLK 测试失败的常规故障排除，请参阅排查 Windows HLK 测试失败问题。
有关故障排除信息，请参阅排查 Device.Graphics 测试问题。
此测试将使用有效参数和无效参数调用 CheckDeviceOverlayType。 它将尝试检查最大覆盖层大小，以及报告为受驱动程序支持的最小覆盖层大小。
如果驱动程序未公开 D3DCAPS_OVERLAY，则测试可能会返回“跳过”。 在某些情况下，如果在创建 D3D 设备期间不支持后台缓冲区格式或模式，可能会跳过。
更多信息
此测试运行以下测试作业：
CheckDeviceOverlayType：
如果适配器索引超出范围，则验证失败。
如果 pDisplayMode 返回与使用当前显示模式填充的 pDisplayMode 相同的结果，则请验证 NULL。
通过查找成功的覆盖类型并在 OverlayFormats 上循环来验证 D3DERR_UNSUPPORTEDOVERLAYFORMAT。
验证是否为无效的宽度和高度返回 D3DERR_UNSUPPORTEDOVERLAY。 作业将查找成功的覆盖类型，并以非标准覆盖大小循环。
CheckDeviceOverlayType 与 CreateDeviceEx 交互：
验证对 CheckDeviceOverlayType 的成功调用是否会导致对 CreateDeviceEx 的成功调用。
警告
在添加驱动程序支持之前，情况始终如此。
验证对 CheckDeviceOverlayType 的调用失败是否会导致对 CreateDeviceEx 的调用失败。
警告
在添加驱动程序支持之前，此测试用例将始终失败。
命令语法
| 命令选项 | 说明 |
|---|---|
D3D9OverlayTest CheckDeviceOverlayType -whql -logclean |
此命令运行 D3D9 Overlay - CheckDeviceOverlayType 测试作业。 |
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 的自定义命令行。 默认值：徽标 |