当前位置：首页 > news >正文

window 显示驱动开发-处理 E_INVALIDARG 返回值

news 来源：原创 2025/5/30 17:05:14

通常，用户模式显示驱动程序不能通过返回E_INVALIDARG来使任何函数失败。但是，如果用户模式显示驱动程序由于驱动程序中的编程错误或操作系统 () 中运行的恶意代码而调用 Microsoft Direct3D 运行时提供的函数之一时收到E_INVALIDARG返回值，则驱动程序必须在运行时调用其中一个驱动程序函数后，将E_INVALIDARG返回到 Direct3D 运行时。否则，用户模式显示驱动程序绝不应将E_INVALIDARG返回到 Direct3D 运行时。

1. 核心规则

禁止主动返回 E_INVALIDARG

用户模式驱动（UMD）不得在任何函数中主动返回 E_INVALIDARG，即使参数明显无效（如 NULL 指针、越界值）。

例外：仅当 Direct3D 运行时本身返回 E_INVALIDARG 时，UMD 可传递此错误。

必须传递运行时返回的 E_INVALIDARG

如果 UMD 调用运行时提供的回调函数（如 pfnAllocateCb）时收到 E_INVALIDARG，必须将错误原样返回给运行时。

2. 适用场景与示例

(1) 合法传递 E_INVALIDARG 的场景

HRESULT APIENTRY CreateResource(D3D10DDI_HDEVICE hDevice,CONST D3D10DDIARG_CREATERESOURCE* pArgs
) {// 调用运行时提供的函数HRESULT hr = pDeviceFuncs->pfnAllocateCb(hDevice, &allocInfo);if (hr == E_INVALIDARG) {return hr; // 必须传递运行时的E_INVALIDARG}// 其他错误处理...
}

(2) 禁止返回 E_INVALIDARG 的场景

HRESULT APIENTRY SetVertexShader(D3D10DDI_HDEVICE hDevice,D3D10DDI_HSHADER hShader
) {if (hShader == NULL) {// 错误！即使参数无效，也不能返回E_INVALIDARGreturn S_OK; // 应静默处理或返回其他错误（如E_FAIL）}
}

3. 设计原理

安全性优先：防止恶意代码利用驱动返回的 E_INVALIDARG 探测系统漏洞。
稳定性保障：避免应用因参数检查不严而崩溃。
调试友好性：强制驱动内部处理无效参数，而非依赖运行时拦截。

4. 异常情况处理

若驱动因自身逻辑错误或恶意代码触发 E_INVALIDARG：

记录错误日志：通过 ETW 或调试输出标记异常。
安全降级：返回 E_FAIL 或 S_OK（视场景而定）。
断言调试：在 Debug 版本中触发断言（如 ASSERT(FALSE)）。

示例：

HRESULT HandleMaliciousCall() {if (IsMaliciousInput()) {DebugPrint("警告：检测到恶意参数");return E_FAIL; // 避免返回E_INVALIDARG}return S_OK;
}

5. WHCK 认证要求

测试项	验证目标	测试方法
`Device.Graphics.UMD.InvalidArgHandling`	驱动是否违规返回 `E_INVALIDARG`。	注入无效参数调用所有 DDI 函数。
`Device.Graphics.UMD.ErrorPropagation`	运行时返回的 `E_INVALIDARG` 是否正确传递。	模拟运行时返回 `E_INVALIDARG`。