DXGKCB_INVALIDATEHWCONTEXT Rückruffunktion (d3dkmddi.h)
Ein Kernelmodusgrafiktreiber (Kernel mode Graphics Driver, KMD) ruft DxgkcbInvalidatehwcontext- auf, um einen Hardwarekontext ungültig zu machen.
Syntax
DXGKCB_INVALIDATEHWCONTEXT DxgkcbInvalidatehwcontext;
NTSTATUS DxgkcbInvalidatehwcontext(
[in] IN_CONST_PDXGKARGCB_INVALIDATEHWCONTEXT unnamedParam1
)
{...}
Parameter
[in] unnamedParam1
Zeigen Sie auf eine DXGKARGCB_INVALIDATEHWCONTEXT-Struktur, die Informationen für Dxgkrnl- enthält, um den Hardwarekontext ungültig zu machen.
Rückgabewert
DxgkcbInvalidatehwcontext gibt STATUS_SUCCESS zurück, wenn der Vorgang erfolgreich ist. Andernfalls wird ein entsprechender NTSTATUS-Fehlercode zurückgegeben.
Bemerkungen
KMD-Aufrufe DxgkcbInvalidatehwcontext, um das System zu benachrichtigen, wenn der Zustand und die Ressourcen, die einem Hardwarekontext zugeordnet sind, nicht mehr gültig oder konsistent sind, sodass der Kontext zurückgesetzt oder neu initialisiert werden muss, bevor er wieder verwendet werden kann. Ein Kontext muss im Falle eines Hardwaremodulzurücksetzungsvorgangs ungültig werden, der aus verschiedenen Gründen, z. B. der Wiederherstellung von einem Fehler oder der Neukonfiguration der GPU-Ressourcen, zurückzuführen sein kann.
Dxgkrnl- kennzeichnet den Kontext als ungültig, sodass er nicht mehr für die Ausführung auf der GPU geplant ist. Anschließend werden alle erforderlichen Bereinigungen initiiert, z. B. das Freigeben von Ressourcen, die dem Kontext zugeordnet sind, oder das Zurücksetzen eines Zustands, der dem Kontext zugeordnet ist.
DXGKCB_XXX Funktionen werden von Dxgkrnlimplementiert. Um diese Rückruffunktion zu verwenden, legen Sie die Member von DXGKARGCB_INVALIDATEHWCONTEXT fest, und rufen Sie dann DxgkCbInvalidateHwContext über die DXGKRNL_INTERFACEauf.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 10, Version 1703 (WDDM 2.2) |
| Header- | d3dkmddi.h |
| IRQL- | PASSIVE_LEVEL |