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

另请参阅

DXGKARGCB_INVALIDATEHWCONTEXT

DXGKRNL_INTERFACE