DXGKCB_INVALIDATEHWCONTEXT callback function (d3dkmddi.h)
A kernel-mode graphics driver (KMD) calls DxgkcbInvalidatehwcontext to invalidate a hardware context.
Syntax
DXGKCB_INVALIDATEHWCONTEXT DxgkcbInvalidatehwcontext;
NTSTATUS DxgkcbInvalidatehwcontext(
[in] IN_CONST_PDXGKARGCB_INVALIDATEHWCONTEXT unnamedParam1
)
{...}
Parameters
[in] unnamedParam1
Pointer to a DXGKARGCB_INVALIDATEHWCONTEXT structure that contains information for Dxgkrnl to use to invalidate the hardware context.
Return value
DxgkcbInvalidatehwcontext returns STATUS_SUCCESS if the operation succeeds. Otherwise, it returns an appropriate NTSTATUS error code.
Remarks
KMD calls DxgkcbInvalidatehwcontext to notify the system when the state and resources associated with a hardware context are no longer valid or consistent, thus requiring that the context be reset or reinitialized before it can be used again. A context needs to be invalidated in the event of a hardware engine reset operation that can be due to a variety of reasons, such as recovery from a fault or reconfiguration of the GPU resources.
Dxgkrnl marks the context as invalid so that it's no longer scheduled for execution on the GPU. It then initiates any necessary cleanup such as releasing resources associated with the context or resetting any state associated with the context.
DXGKCB_XXX functions are implemented by Dxgkrnl. To use this callback function, set the members of DXGKARGCB_INVALIDATEHWCONTEXT and then call DxgkCbInvalidateHwContext via the DXGKRNL_INTERFACE.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 10, version 1703 (WDDM 2.2) |
| Header | d3dkmddi.h |
| IRQL | PASSIVE_LEVEL |