Expand Minimize

DxgkDdiResetEngine routine

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


PDXGKDDI_RESETENGINE DxgkDdiResetEngine;

NTSTATUS APIENTRY DxgkDdiResetEngine(
  _In_     const HANDLE hAdapter,
  _Inout_  DXGKARG_RESETENGINE *pResetEngine

)
{ ... }

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 DirectX graphics kernel subsystem in the MiniportDeviceContext output parameter of the DxgkDdiAddDevice function.

pResetEngine [in, out]

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

Minimum supported client

Windows 8

Minimum supported server

Windows Server 2012

Header

D3dkmddi.h (include D3dkmddi.h)

IRQL

PASSIVE_LEVEL

See also

DXGKARG_RESETENGINE
DxgkDdiAddDevice

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft