Fonction IoCsqInitialize (wdm.h)

Article
07/02/2025

La IoCsqInitialize routine initialise la table de répartition de file d’attente IRP annulée du pilote.

Syntaxe

C++

NTSTATUS IoCsqInitialize(
  [out] PIO_CSQ                       Csq,
  [in]  PIO_CSQ_INSERT_IRP            CsqInsertIrp,
  [in]  PIO_CSQ_REMOVE_IRP            CsqRemoveIrp,
  [in]  PIO_CSQ_PEEK_NEXT_IRP         CsqPeekNextIrp,
  [in]  PIO_CSQ_ACQUIRE_LOCK          CsqAcquireLock,
  [in]  PIO_CSQ_RELEASE_LOCK          CsqReleaseLock,
  [in]  PIO_CSQ_COMPLETE_CANCELED_IRP CsqCompleteCanceledIrp
);

Paramètres

[out] Csq

Pointeur vers la structure IO_CSQ à initialiser par IoCsqInitialize.

[in] CsqInsertIrp

Pointeur vers la fonction CsqInsertIrp définie par le pilote pour la file d’attente IRP annulée du pilote.

[in] CsqRemoveIrp

Pointeur vers la fonction CsqRemoveIrp définie par le pilote pour la file d’attente IRP annulée du pilote.

[in] CsqPeekNextIrp

Pointeur vers la fonction CsqPeekNextIrp définie par le pilote pour la file d’attente IRP annulée du pilote.

[in] CsqAcquireLock

Pointeur vers la fonction CsqAcquireLock définie par le pilote pour la file d’attente IRP annulée du pilote.

[in] CsqReleaseLock

Pointeur vers la fonction CsqReleaseLock définie par le pilote pour la file d’attente IRP annulée du pilote.

[in] CsqCompleteCanceledIrp

Pointeur vers la fonction CsqCompleteCanceledIrp définie par le pilote pour la file d’attente IRP annulée du pilote.

Valeur de retour

Cette routine retourne STATUS_SUCCESS en cas de réussite ou le code d’erreur NTSTATUS approprié en cas d’échec.

Remarques

La routine IoCsqInitialize initialise une structure IO_CSQ qui décrit la file d’attente IRP annulée d’un pilote. Les pilotes peuvent également utiliser IoCsqInitializeEx pour créer une file d’attente IRP avec des fonctionnalités étendues. 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é.

Exigences

Exigence	Valeur
client minimum pris en charge	Disponible dans Windows XP et versions ultérieures du système d’exploitation Windows. Les pilotes qui doivent également fonctionner pour 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	N’importe quel niveau