DXGKDDI_RESETHWENGINE Rückruffunktion (d3dkmddi.h)
Dxgkrnl- ruft die KMD -DxgkDdiResetHwEngine Funktion auf, wenn ein ZURÜCKSETZEN eines GPU-Moduls erforderlich ist.
Syntax
DXGKDDI_RESETHWENGINE DxgkddiResethwengine;
NTSTATUS DxgkddiResethwengine(
IN_CONST_HANDLE hAdapter,
INOUT_PDXGKARG_RESETHWENGINE pResetHwEngine
)
{...}
Parameter
hAdapter
[in] Ein Handle zum Kontextblock, der einem Anzeigeadapter zugeordnet ist. KMD hat dieses Handle zuvor für Dxgkrnl- im MiniportDeviceContext Ausgabeparameter der funktion DxgkDdiAddDevice bereitgestellt.
pResetHwEngine
[in/out] Zeigen Sie auf eine DXGKARG_RESETHWENGINE-Struktur, die Informationen zum Zurücksetzen des Hardwaremoduls enthält.
Rückgabewert
DxgkDdiResetHwEngine- gibt STATUS_SUCCESS zurück, wenn der Vorgang erfolgreich ist. Andernfalls sollte ein entsprechender NTSTATUS-Fehlercode zurückgegeben werden.
Bemerkungen
Eine DxgkDdiResetHwEngine--Implementierung sollte die DxgkCbInvalidateHwContext Rückruf aufrufen, um das Betriebssystem über alle ausgeführten Kontexte zu informieren, die vom Zurücksetzen des GPU-Moduls betroffen waren. Das Betriebssystem wird diese Kontextgeräte ungültig machen (sie im Fehler festlegen) und führt keine zukünftigen Übermittlungen durch.
Das Modul wird noch nicht als fortgesetzt betrachtet, nachdem DxgkDdiResetHwEngine- aufgerufen wurde, sodass Kontexte, die nicht ungültig waren, nicht übermittelt werden dürfen. Das Betriebssystem muss Unterbrechungen von diesem Modul erneut aktivieren und seinen Zustand mit dem Zurücksetzen des GPU-Moduls synchronisieren. Danach aktiviert das Betriebssystem Unterbrechungen und Aufrufe DxgkDdiResumeHwEngine, wodurch das GPU-Modul angewiesen wird, die Planung aller ausgeführten Kontexte zu starten, die von der Modulzurücksetzung nicht betroffen waren.
Registrieren Sie ihre Implementierung dieser Rückruffunktion in der **DRIVER_INITIALIZATION_DATA ** Struktur.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 10, Version 1703 (WDDM 2.2) |
| Header- | d3dkmddi.h |