DXGKDDI_RESETENGINE Rückruffunktion (d3dkmddi.h)
Der GPU-Scheduler des Anzeigeporttreibers ruft die KMD (Miniporttreiber) DxgkDdiResetEngine--Funktion auf, um einen aktiven Knoten auf einem physischen Anzeigeadapter 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 zu einem Kontextblock, der einem Anzeigeadapter 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 eine der fehlercodes zurück, die in ntstatus.hdefiniert sind.
Bemerkungen
Der KMD sollte von einem Aufruf dieser Funktion nur zurückgegeben werden, wenn alle folgenden Kriterien erfüllt sind:
- Der Rücksetzungsvorgang ist abgeschlossen.
- Nichts verbleibt in der Hardwarewarteschlange des physischen Adapters.
- Die angegebenen Knoten sind bereit, neue Pakete zu akzeptieren.
Diese Funktion sollte seitenfähig gemacht werden.
Das Betriebssystem garantiert, dass diese Funktion dem Synchronisierungsmodus der ersten Ebenefolgt.
Weitere Informationen finden Sie unter TDR-Änderungen in Windows 8.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 8 |
| mindestens unterstützte Server- | Windows Server 2012 |
| Zielplattform- | Desktop |
| Header- | d3dkmddi.h |
| IRQL- | PASSIVE_LEVEL |