DXGKDDI_RESETFROMTIMEOUT - NtDoc

Native API online documentation, based on the System Informer (formerly Process Hacker) phnt headers
// d3dkmddi.h

DXGKDDI_RESETFROMTIMEOUT DxgkddiResetfromtimeout;

NTSTATUS DxgkddiResetfromtimeout(
  [in] IN_CONST_HANDLE hAdapter
)
{...}
View the official Windows Driver Kit DDI reference

NtDoc

No description available.

Windows Driver Kit DDI reference (nc-d3dkmddi-dxgkddi_resetfromtimeout)

DXGKDDI_RESETFROMTIMEOUT callback function

Description

The DxgkDdiResetFromTimeout function resets the graphics processing unit (GPU) after a hardware timeout occurs and guarantees that the GPU is not writing or reading any memory by the time that DxgkDdiResetFromTimeout returns.

Parameters

hAdapter [in]

A handle to a context block that is associated with a display adapter. The display miniport driver previously provided this handle to the Microsoft DirectX graphics kernel subsystem in the MiniportDeviceContext output parameter of the DxgkDdiAddDevice function.

Return value

DxgkDdiResetFromTimeout returns STATUS_SUCCESS to indicate that the driver handled the call successfully; otherwise, the operating system bug checks and causes a restart.

Remarks

The GPU scheduler calls DxgkDdiResetFromTimeout when it detects that a hardware time-out occurred. The time-out is typically a delayed response to a preempt request. DxgkDdiResetFromTimeout should reset the GPU.

For more information about time-outs in this situation, see Thread Synchronization and TDR.

DxgkDdiResetFromTimeout should be made pageable.

See also

DxgkDdiAddDevice

DxgkDdiReleaseSwizzlingRange

DxgkDdiRestartFromTimeout