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 de retour
KeRemoveQueueDpc retourne TRUE si l’objet DPC se trouve dans la file d’attente DPC. Si l’objet DPC spécifié n’est pas actuellement dans la file d’attente DPC, aucune opération n’est effectuée et FAUX est retourné.
Remarques
Si l’objet DPC spécifié est actuellement mis en file d’attente, il est supprimé de la file d’attente, en annulant un appel à la routine DPC associée.
À compter de Windows Vista avec Service Pack 1 (SP1) et Windows Server 2008, une valeur de retour de TRUE signifie toujours que KeRemoveQueueDpc supprimé correctement l’objet DPC de la file d’attente DPC avant que la routine DPC ne commence à s’exécuter. 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 identiquement.