DXGKDDI_RESUMEHWENGINE Rückruffunktion (d3dkmddi.h)
Dxgkrnl ruft DxgkDdiResumeHwEngine auf, nachdem eine GPU-Engine erfolgreich zurückgesetzt wurde, um den GPU-Planer anzuweisen, Kontexte erneut zu übermitteln, die durch das Zurücksetzen nicht ungültig wurden.
Syntax
DXGKDDI_RESUMEHWENGINE DxgkddiResumehwengine;
NTSTATUS DxgkddiResumehwengine(
IN_CONST_HANDLE hAdapter,
INOUT_PDXGKARG_RESUMEHWENGINE pResumeHwEngine
)
{...}
Parameter
hAdapter
[in] Ein Handle für den Kontextblock, der einer Grafikkarte zugeordnet ist. KMD hat dieses Handle zuvor für Dxgkrnl im MiniportDeviceContext-Ausgabeparameter der DxgkDdiAddDevice-Funktion bereitgestellt.
pResumeHwEngine
[in/out] Zeiger auf eine DXGKARG_RESUMEHWENGINE Struktur, die Informationen zum Fortsetzen der Hardware-Engine enthält.
Rückgabewert
DxgkDdiResumeHwEngine gibt STATUS_SUCCESS zurück, wenn der Vorgang erfolgreich ist. Andernfalls sollte ein entsprechender NTSTATUS-Fehlercode zurückgegeben werden. Wenn der Aufruf fehlschlägt, führt das Betriebssystem eine vollständige GPU-Zurücksetzung durch.
Hinweise
Die Engine gilt noch nicht als fortgesetzt, nachdem DxgkDdiResetHwEngine aufgerufen wurde, sodass auch Kontexte, die nicht ungültig wurden, nicht übermittelt werden dürfen. Das Betriebssystem muss Interrupts von dieser Engine erneut aktivieren und seinen Zustand mit der ZURÜCKSETZEN-GPU-Engine synchronisieren. Danach aktiviert das Betriebssystem Interrupts und ruft DxgkDdiResumeHwEngine auf. Dadurch wird die GPU-Engine angewiesen, alle ausgeführten Kontexte zu planen, die nicht vom Zurücksetzen der Engine betroffen waren.
Registrieren Sie Ihre Implementierung dieser Rückruffunktion in der **DRIVER_INITIALIZATION_DATA ** -Struktur.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 10, Version 1703 (WDDM 2.2) |
| Kopfzeile | d3dkmddi.h |