KeRemoveQueueDpc, fonction (wdm.h)

La routine KeRemoveQueueDpc supprime l’objet DPC spécifié de la file d’attente DPC système.

Syntaxe

BOOLEAN KeRemoveQueueDpc(
  [in, out] PRKDPC Dpc
);

Paramètres

[in, out] Dpc

Pointeur vers un objet DPC initialisé mis en file d’attente par un appel précédent à la routine KeInsertQueueDpc .

Valeur retournée

KeRemoveQueueDpc retourne TRUE si l’objet DPC se trouve dans la file d’attente DPC. Si l’objet DPC spécifié ne se trouve pas actuellement dans la file d’attente DPC, aucune opération n’est effectuée et FALSE est retourné.

Remarques

Si l’objet DPC spécifié est actuellement mis en file d’attente, il est supprimé de la file d’attente, ce qui annule un appel à la routine DPC associée.

À compter de Windows Vista avec Service Pack 1 (SP1) et Windows Server 2008, la valeur de retour TRUE signifie toujours que KeRemoveQueueDpc a supprimé l’objet DPC de la file d’attente DPC avant le début de l’exécution de la routine DPC. Dans les versions antérieures de Windows, la routine DPC peut parfois s’exécuter même si KeRemoveQueueDpc retourne TRUE. Dans ces versions antérieures de Windows, les pilotes qui ne peuvent pas tolérer l’ambiguïté dans la valeur de retour TRUE doivent traiter les valeurs de retour de TRUE et FALSE de manière identique.

Configuration requise

Voir aussi

KeInitializeDpc

KeInsertQueueDpc