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é à un état d’erreur. Un tel état d’erreur est généralement dû à un événement de détection et de récupération (TDR).

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 MiniportDeviceContext paramètre de sortie de la fonction DxgkDdiAddDevice.

pCancelCommand

Pointeur vers une structure DXGKARG_CANCELCOMMAND qui spécifie les ressources à nettoyer une fois qu’une commande est supprimée de la file d’attente matérielle.

Valeur de retour

Retourne STATUS_SUCCESS une fois l’opération terminée. Si le pilote retourne plutôt un code d’erreur, le système d’exploitation provoque une vérification de bogue système. Pour plus d’informations, consultez la section Remarques suivante.

Remarques

Remarque 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 de bogue système. Dans un fichier de vidage sur incident, l’erreur est notée par le message BugCheck 0x119, qui a 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 du planificateur interne

Exigences

Exigence Valeur
client minimum pris en charge Windows 8
serveur minimum pris en charge Windows Server 2012
plateforme cible Bureau
d’en-tête d3dkmddi.h
IRQL PASSIVE_LEVEL

Voir aussi

DXGKARG_CANCELCOMMAND

DXGK_VIDSCHCAPS

DxgkDdiAddDevice