DXGKDDI_RESTARTFROMTIMEOUT callback function (d3dkmddi.h)

The DxgkDdiRestartFromTimeout function indicates that the driver can access the graphics processing unit (GPU) again after the recovery from a hardware timeout has completed.

Syntax

DXGKDDI_RESTARTFROMTIMEOUT DxgkddiRestartfromtimeout;

NTSTATUS DxgkddiRestartfromtimeout(
  [in] IN_CONST_HANDLE hAdapter
)
{...}

Parameters

[in] hAdapter

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

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

Remarks

The operating system calls the DxgkDdiRestartFromTimeout function after the recovery of a hardware time-out completes from the operating system's perspective (for example, all of the system-managed resources, mappings, and so on are released). The DxgkDdiRestartFromTimeout function indicates that the driver can begin to access the GPU and release any driver-managed resources. However, most drivers might not be required to perform any actions during a call to DxgkDdiRestartFromTimeout. Regardless of whether DxgkDdiRestartFromTimeout performs any actions, it must still be implemented and can simply return STATUS_SUCCESS immediately.

DxgkDdiRestartFromTimeout should be made pageable.

Requirements

See also

DxgkDdiAddDevice

DxgkDdiResetFromTimeout