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 |