DXGKCB_INVALIDATEHWCONTEXT - NtDoc
Native API online documentation, based on the System Informer
(formerly Process Hacker) phnt
headers
// d3dkmddi.h
DXGKCB_INVALIDATEHWCONTEXT DxgkcbInvalidatehwcontext;
NTSTATUS DxgkcbInvalidatehwcontext(
[in] IN_CONST_PDXGKARGCB_INVALIDATEHWCONTEXT unnamedParam1
)
{...}
View the official Windows Driver Kit DDI referenceNo description available.
A kernel-mode graphics driver (KMD) calls DxgkcbInvalidatehwcontext to invalidate a hardware context.
unnamedParam1 [in]Pointer to a DXGKARGCB_INVALIDATEHWCONTEXT structure that contains information for Dxgkrnl to use to invalidate the hardware context.
DxgkcbInvalidatehwcontext returns STATUS_SUCCESS if the operation succeeds. Otherwise, it returns an appropriate NTSTATUS error code.
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.