DXGKCB_INVALIDATEHWCONTEXT fonction de rappel (d3dkmddi.h)
Un pilote graphique en mode noyau appelle DxgkcbInvalidatehwcontext pour invalider un contexte matériel.
Syntaxe
DXGKCB_INVALIDATEHWCONTEXT DxgkcbInvalidatehwcontext;
NTSTATUS DxgkcbInvalidatehwcontext(
[in] IN_CONST_PDXGKARGCB_INVALIDATEHWCONTEXT unnamedParam1
)
{...}
Paramètres
[in] unnamedParam1
Pointeur vers une structure DXGKARGCB_INVALIDATEHWCONTEXT qui contient des informations pour Dxgkrnl à utiliser pour invalider le contexte matériel.
Valeur de retour
DxgkcbInvalidatehwcontext retourne STATUS_SUCCESS si l’opération réussit. Sinon, elle retourne un code d’erreur NTSTATUS approprié.
Remarques
Les appels KMD DxgkcbInvalidatehwcontext pour notifier le système lorsque l’état et les ressources associés à un contexte matériel ne sont plus valides ou cohérents, ce qui nécessite que le contexte soit réinitialisé avant de pouvoir être réutilisé. Un contexte doit être invalidé en cas d’opération de réinitialisation du moteur matériel pouvant être due à diverses raisons, telles que la récupération à partir d’une erreur ou la reconfiguration des ressources GPU.
Dxgkrnl marque le contexte comme non valide afin qu’il ne soit plus planifié pour l’exécution sur le GPU. Il lance ensuite tout nettoyage nécessaire, par exemple la libération de ressources associées au contexte ou la réinitialisation d’un état associé au contexte.
DXGKCB_XXX fonctions sont implémentées par Dxgkrnl. Pour utiliser cette fonction de rappel, définissez les membres de DXGKARGCB_INVALIDATEHWCONTEXT, puis appelez DxgkCbInvalidateHwContext via le DXGKRNL_INTERFACE.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows 10, version 1703 (WDDM 2.2) |
| d’en-tête | d3dkmddi.h |
| IRQL | PASSIVE_LEVEL |