DXGKDDI_RESETENGINE callback function (d3dkmddi.h)
The display port driver's GPU scheduler calls the miniport driver's (KMD's) DxgkDdiResetEngine 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
[in] A handle to a context block that is associated with a display adapter. The KMD previously provided this handle to Dxgkrnl in the MiniportDeviceContext output parameter of the DxgkDdiAddDevice function.
pResetEngine
[in/out] A DXGKARG_RESETENGINE structure that specifies the node to be reset and supplies a fence identifier for the last aborted packet.
Return value
DxgkDdiResetEngine returns STATUS_SUCCESS if the function succeeds. Otherwise, this function returns one of the error codes defined in Ntstatus.h.
Remarks
The KMD should return from a call to this function only when all of the following criteria are met:
- The reset operation is completed.
- Nothing remains in the physical adapter's hardware queue.
- 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.
For more information, see TDR changes in Windows 8.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 8 |
| Minimum supported server | Windows Server 2012 |
| Target Platform | Desktop |
| Header | d3dkmddi.h |
| IRQL | PASSIVE_LEVEL |