DXGKDDI_RESETHWENGINE Rückruffunktion (d3dkmddi.h)

Dxgkrnl ruft die DxgkDdiResetHwEngine-Funktion des Anzeige-Miniporttreibers (KMD) auf, wenn ein Zurücksetzen der GPU-Engine erforderlich ist.

Syntax

DXGKDDI_RESETHWENGINE DxgkddiResethwengine;

NTSTATUS DxgkddiResethwengine(
  IN_CONST_HANDLE hAdapter,
  INOUT_PDXGKARG_RESETHWENGINE pResetHwEngine
)
{...}

Parameter

hAdapter

[in] Ein Handle für den Kontextblock, der einem Anzeigeadapter zugeordnet ist. KMD hat diesen Handle zuvor für Dxgkrnl im MiniportDeviceContext-Ausgabeparameter der DxgkDdiAddDevice-Funktion bereitgestellt.

pResetHwEngine

[ein/aus] Zeiger auf eine DXGKARG_RESETHWENGINE-Struktur , die Informationen zum Zurücksetzen der Hardware-Engine enthält.

Rückgabewert

DxgkDdiResetHwEngine gibt STATUS_SUCCESS zurück, wenn der Vorgang erfolgreich ist. Andernfalls sollte ein entsprechender NTSTATUS-Fehlercode zurückgegeben werden.

Hinweise

Eine DxgkDdiResetHwEngine-Implementierung sollte den DxgkCbInvalidateHwContext-Rückruf aufrufen, um das Betriebssystem über alle ausgeführten Kontexte zu informieren, die vom Vorgang zum Zurücksetzen der GPU-Engine betroffen sind. Das Betriebssystem ungültig macht diese Kontextgeräte ungültig (legt sie als Fehler fest) und führt keine zukünftigen Übermittlungen aus.

Die Engine wird noch nicht als fortgesetzt betrachtet, nachdem DxgkDdiResetHwEngine aufgerufen wurde, sodass Kontexte, die nicht ungültig wurden, nicht übermittelt werden dürfen. Das Betriebssystem muss Interrupts dieses Moduls erneut aktivieren und seinen Zustand mit der zurückgesetzten GPU-Engine synchronisieren. Danach aktiviert das Betriebssystem Interrupts und ruft DxgkDdiResumeHwEngine auf, wodurch die GPU-Engine angewiesen wird, alle ausgeführten Kontexte zu planen, die nicht von der Enginezurücksetzung betroffen waren.

Registrieren Sie Ihre Implementierung dieser Rückruffunktion in der **DRIVER_INITIALIZATION_DATA ** -Struktur.

Anforderungen

Weitere Informationen

DXGKARG_RESETHWENGINE

DxgkDdiResumeHwEngine