DXGKDDI_RESETENGINE function

The display port driver's GPU scheduler calls this function to reset an active node on a physical display adapter when the scheduler detects a timeout condition on the adapter.

Syntax

DXGKDDI_RESETENGINE DxgkddiResetengine;

NTSTATUS DxgkddiResetengine(
  IN_CONST_HANDLE hAdapter,
  INOUT_PDXGKARG_RESETENGINE pResetEngine
)
{...}

Parameters

hAdapter

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

pResetEngine

A value of type DXGKARG_RESETENGINE that specifies nodes that are to be reset and supplies a fence identifier for the last aborted packet.

Return Value

Returns STATUS_SUCCESS if the function succeeds. Otherwise, this function returns one of the error codes defined in Ntstatus.h.

Remarks

The display miniport driver should return from a call to this function only when the reset operation is completed, nothing remains in the physical adapter's hardware queue, and the specified nodes are ready to accept new packets.

This function should be made pageable.

The operating system guarantees that this function follows the first level synchronization mode as defined in Threading and Synchronization First Level.

For more information, see TDR changes in Windows 8.

Requirements

   
Windows version Windows 8 Windows Server 2012
Target Platform Desktop
Header d3dkmddi.h
IRQL PASSIVE_LEVEL

See Also

DXGKARG_RESETENGINE

DxgkDdiAddDevice

Send comments about this topic to Microsoft