DXGKDDI_CANCELCOMMAND fonction de rappel (d3dkmddi.h)

Nettoie les ressources internes associées à un paquet d’accès direct à la mémoire (DMA) qui se trouvait dans la file d’attente logicielle du planificateur GPU, mais qui n’a jamais atteint la file d’attente matérielle, car l’appareil est passé dans un état d’erreur. Un tel état d’erreur est généralement dû à un événement TDR (Timeout Detection and Recovery).

Syntaxe

DXGKDDI_CANCELCOMMAND DxgkddiCancelcommand;

NTSTATUS DxgkddiCancelcommand(
  IN_CONST_HANDLE hAdapter,
  IN_CONST_PDXGKARG_CANCELCOMMAND pCancelCommand
)
{...}

Paramètres

hAdapter

Handle vers un bloc de contexte associé à un adaptateur d’affichage. Le pilote miniport d’affichage a précédemment fourni ce handle au sous-système du noyau graphique DirectX dans le paramètre de sortie MiniportDeviceContext de la fonction DxgkDdiAddDevice .

pCancelCommand

Pointeur vers une structure de DXGKARG_CANCELCOMMAND qui spécifie les ressources à nettoyer après la suppression d’une commande de la file d’attente matérielle.

Valeur retournée

Retourne STATUS_SUCCESS en cas de réussite de l’exécution. Si le pilote retourne à la place un code d’erreur, le système d’exploitation provoque une vérification d’erreur système. Pour plus d'informations, consultez la section Notes qui suit.

Remarques

Si le pilote retourne un code d’erreur, le sous-système du noyau graphique DirectX provoque une vérification d’erreur système. Dans un fichier de vidage sur incident, l’erreur est notée par le message BugCheck 0x119, qui contient les quatre paramètres suivants.

1. 0x9
2. Code d’erreur NTSTATUS retourné par l’appel de pilote ayant échoué
3. Pointeur vers la structure DXGKARG_CANCELCOMMAND
4. Pointeur vers une structure de données de planificateur interne

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 8
Serveur minimal pris en charge	Windows Server 2012
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	d3dkmddi.h
IRQL	PASSIVE_LEVEL

Voir aussi

DXGKARG_CANCELCOMMAND

DXGK_VIDSCHCAPS

DxgkDdiAddDevice