Partager via


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

Note Le sous-système du noyau graphique DirectX appelle cette fonction uniquement si le DXGK_VIDSCHCAPS. Le membre CancelCommandAware est défini.
 
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