KeInsertQueueDpc, fonction (wdm.h)

Article
02/29/2024

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)

Voir aussi