DXGKCB_INVALIDATEHWCONTEXT回调函数 (d3dkmddi.h)
内核模式图形驱动程序(KMD)调用 DxgkcbInvalidatehwcontext 使硬件上下文失效。
语法
DXGKCB_INVALIDATEHWCONTEXT DxgkcbInvalidatehwcontext;
NTSTATUS DxgkcbInvalidatehwcontext(
[in] IN_CONST_PDXGKARGCB_INVALIDATEHWCONTEXT unnamedParam1
)
{...}
参数
[in] unnamedParam1
指向 DXGKARGCB_INVALIDATEHWCONTEXT 结构的指针,该结构包含用于使硬件上下文失效的 Dxgkrnl 的信息。
返回值
DxgkcbInvalidatehwcontext 如果作成功,则返回STATUS_SUCCESS。 否则,它将返回适当的 NTSTATUS 错误代码。
言论
KMD 调用 DxgkcbInvalidatehwcontext,以在与硬件上下文关联的状态和资源不再有效或一致时通知系统,因此需要重置或重新初始化上下文,然后才能再次使用它。 当硬件引擎重置作可能由于各种原因(例如从故障恢复或重新配置 GPU 资源)时,上下文需要失效。
Dxgkrnl 将上下文标记为无效,以便不再计划在 GPU 上执行。 然后,它会启动任何必要的清理,例如释放与上下文关联的资源或重置与上下文关联的任何状态。
DXGKCB_XXX 函数由 Dxgkrnl实现。 若要使用此回调函数,请设置 DXGKARGCB_INVALIDATEHWCONTEXT 的成员,然后通过 DXGKRNL_INTERFACE调用 DxgkCbInvalidateHwContext。
要求
要求 | 价值 |
---|---|
最低支持的客户端 | Windows 10 版本 1703 (WDDM 2.2) |
标头 | d3dkmddi.h |
IRQL | PASSIVE_LEVEL |