Fonction IoCsqInsertIrpEx (wdm.h)

Article
02/07/2025

La routine IoCsqInsertIrpEx insère un IRP dans la file d’attente IRP annulée du pilote.

Syntaxe

NTSTATUS IoCsqInsertIrpEx(
  [in, out]       PIO_CSQ             Csq,
  [in, out]       PIRP                Irp,
  [out, optional] PIO_CSQ_IRP_CONTEXT Context,
  [in, optional]  PVOID               InsertContext
);

Paramètres

[in, out] Csq

Pointeur vers la structure IO_CSQ pour la file d’attente IRP annuler-safe du pilote. Cette structure doit avoir été initialisée par IoCsqInitialize ou IoCsqInitializeEx.

[in, out] Irp

Pointeur vers l’IRP à mettre en file d’attente.

[out, optional] Context

Pointeur vers une structure IO_CSQ_IRP_CONTEXT. IoCsqInsertIrpEx initialise cette structure avec des informations de contexte pour l’IRP inséré. Le pilote transmet cette valeur à IoCsqRemoveIrp pour supprimer l’IRP de la file d’attente. de contexte peut être NULL si le pilote n’utilise pas IoCsqRemoveIrp pour supprimer cet IRP de la file d’attente.

[in, optional] InsertContext

Pointeur vers une valeur de contexte définie par le pilote. Ce paramètre est transmis à la routine CsqInsertIrpEx du pilote, s’il en a un. Sinon, ce paramètre est ignoré.

Valeur de retour

Si le paramètre Csq a été initialisé avec IoCsqInitialize, IoCsqInsertIrpEx retourne toujours STATUS_SUCCESS. Si Csq a été initialisé avec IoCsqInitializeEx, IoCsqInsertIrpEx retourne la valeur retournée par la routine CsqInsertIrpEx du pilote.

Remarques

IoCsqInsertIrpEx utilise les routines de répartition de la file d’attente pour insérer l’IRP. La routine IoCsqInsertIrpEx :

Appelle la routine CsqAcquireLock de la file d’attente pour verrouiller la file d’attente.
Si la structure IO_CSQ de la file d’attente a été initialisée par IoCsqInitialize, IoCsqInsertIrpEx appelle la routine CsqInsertIrp de la file d’attente pour insérer la routine IRP. Si la structure IO_CSQ de la file d’attente a été initialisée par IoCsqInitializeEx, IoCsqInsertIrpEx appelle la routine CsqInsertIrpEx de la file d’attente pour insérer l’IRP, et transmet le paramètre InsertContext en tant que paramètre de InsertContext de CsqInsertIrpEx.
Appelle la routine CsqReleaseLock de la file d’attente pour déverrouiller la file d’attente.

Si l’IRP à insérer a déjà été annulé, IoCsqInsertIrpEx ne tente pas d’insérer l’IRP dans la file d’attente.

Pour plus d’informations, consultez Cancel-Safe files d’attente IRP.

Notez que les routines IoCsqXxx utilisent le membre DriverContext[3] de l’IRP pour contenir des informations de contexte IRP. Les pilotes qui utilisent ces routines pour mettre en file d’attente les fournisseurs d’intégration doivent laisser ce membre inutilisé.

Les appelants de IoCsqInsertIrpEx doivent s’exécuter à un <IRQL = DISPATCH_LEVEL. Les routines de rappel du pilote doivent fonctionner correctement à ce runtime IRQL.

Exigences

Exigence	Valeur
client minimum pris en charge	Disponible dans Windows Server 2003 et versions ultérieures du système d’exploitation Windows. La routine est également disponible dans la bibliothèque Csq.lib fournie avec le Kit de pilotes Windows (WDK) et le Kit de développement de pilotes (DDK) pour Windows Server 2003. Les pilotes qui doivent également fonctionner sur Windows XP, Windows 2000 et Windows 98/Me peuvent à la place lier à Csq.lib pour utiliser la routine.
plateforme cible	Universel
d’en-tête	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
bibliothèque	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= DISPATCH_LEVEL (voir la section Remarques)
règles de conformité DDI	IoAllocateFree(wdm), IoReuseIrp(wdm), IrpCancelField(wdm), RemoveRemoveLockCheck(wdm), RemoveLockForward(wdm), RemoveLockForward2(wdm), RemoveLockForwardDeviceControl (wdm), RemoveLockForwardDeviceControl2(wdm), RemoveLockForwardDeviceControlInternal(wdm), RemoveLockForwardDeviceControlInternal2(wdm), RemoveLockForwardRead(wdm), RemoveLockForwardRead2(wdm), RemoveLockForwardWrite(wdm), RemoveLockForwardWrite2(wdm), RemoveLockReleaseCleanup(wdm), RemoveLockReleaseClose(wdm), RemoveLockReleaseCreate(wdm), RemoveLockReleaseDeviceControl(wdm), RemoveLockReleaseInternalDeviceControl(wdm), RemoveLockReleasePower(wdm), RemoveLockReleaseRead(wdm), RemoveLockReleaseShutdown(wdm), RemoveLockReleaseSystemControl(wdm), RemoveLockReleaseWrite(wdm)