KeInsertQueueDpc, fonction (wdm.h)
La routine KeInsertQueueDpc met en file d’attente un DPC pour exécution.
Syntaxe
BOOLEAN KeInsertQueueDpc(
[in, out] PRKDPC Dpc,
[in, optional] PVOID SystemArgument1,
[in, optional] __drv_aliasesMem PVOID SystemArgument2
);
Paramètres
[in, out] Dpc
Pointeur vers la structure KDPC pour l’objet DPC. Cette structure doit avoir été initialisée par KeInitializeDpc ou KeInitializeThreadedDpc.
[in, optional] SystemArgument1
Spécifie les données de contexte déterminées par le pilote. Cette valeur est passée en tant que paramètre SystemArgument1 à la routine CustomDpc ou CustomThreadedDpc de l’objet DPC.
[in, optional] SystemArgument2
Spécifie les données de contexte déterminées par le pilote. Cette valeur est passée en tant que paramètre SystemArgument2 à la routine CustomDpc ou CustomThreadedDpc de l’objet DPC.
Valeur retournée
Si l’objet DPC spécifié n’est pas actuellement dans une file d’attente DPC, KeInsertQueueDpc met en file d’attente la DPC et retourne TRUE.
Remarques
Si l’objet DPC spécifié a déjà été mis en file d’attente, aucune opération n’est effectuée, sauf pour retourner FALSE. Sinon, l’objet DPC est inséré dans une file d’attente DPC. Pour plus d’informations sur les files d’attente DPC, consultez Organisation des files d’attente DPC.
Notez qu’un objet DPC particulier et la fonction qu’il représente ne peuvent être mis en file d’attente pour l’exécution qu’une seule fois à un moment donné.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Disponible à partir de Windows 2000. |
| Plateforme cible | Universal |
| En-tête | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| Bibliothèque | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | N’importe quel niveau |
| Règles de conformité DDI | HwStorPortProhibitedDDIs(storport), MarkingQueuedIrps(wdm) |