DXGKDDI_RESETENGINE Rückruffunktion (d3dkmddi.h)

Der GPU-Scheduler des Anzeigeporttreibers ruft die DxgkDdiResetEngine-Funktion des Miniporttreibers (KMD) auf, um einen aktiven Knoten auf einem physischen Grafikkarte zurückzusetzen, wenn der Planer eine Timeoutbedingung auf dem Adapter erkennt.

Syntax

DXGKDDI_RESETENGINE DxgkddiResetengine;

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

Parameter

hAdapter

[in] Ein Handle für einen Kontextblock, der einer Grafikkarte zugeordnet ist. Der KMD hat dieses Handle zuvor für Dxgkrnl im MiniportDeviceContext-Ausgabeparameter der DxgkDdiAddDevice-Funktion bereitgestellt.

pResetEngine

[in/out] Eine DXGKARG_RESETENGINE-Struktur , die den zurückzusetzenden Knoten angibt und einen Zaunbezeichner für das letzte abgebrochene Paket bereitstellt.

Rückgabewert

DxgkDdiResetEngine gibt STATUS_SUCCESS zurück, wenn die Funktion erfolgreich ist. Andernfalls gibt diese Funktion einen der in Ntstatus.h definierten Fehlercodes zurück.

Hinweise

Die KMD sollte von einem Aufruf dieser Funktion nur zurückgegeben werden, wenn alle der folgenden Kriterien erfüllt sind:

• Der Zurücksetzungsvorgang ist abgeschlossen.
• Nichts verbleibt in der Hardwarewarteschlange des physischen Adapters.
• Die angegebenen Knoten sind bereit, neue Pakete zu akzeptieren.

Diese Funktion sollte ausgelagert werden.

Das Betriebssystem garantiert, dass diese Funktion dem Synchronisierungsmodus der ersten Ebene folgt.

Weitere Informationen finden Sie unter TDR-Änderungen in Windows 8.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8
Unterstützte Mindestversion (Server)	Windows Server 2012
Zielplattform	Desktop
Kopfzeile	d3dkmddi.h
IRQL	PASSIVE_LEVEL

Weitere Informationen

DXGKARG_RESETENGINE

DxgkDdiAddDevice