Fonction IoMakeAssociatedIrp (ntddk.h)

Article
02/26/2024

Cette routine est réservée aux systèmes de fichiers et aux pilotes de filtre de système de fichiers. La routine IoMakeAssociatedIrp alloue et initialise un IRP à associer à un master IRP envoyé à un pilote de niveau supérieur, ce qui permet à l’appelant de fractionner la demande d’origine et d’envoyer des IRP associés aux pilotes de niveau inférieur.

Syntaxe

PIRP IoMakeAssociatedIrp(
  [in] PIRP  Irp,
  [in] CCHAR StackSize
);

Paramètres

[in] Irp

Pointeur vers le master IRP entré dans la routine Dispatch d’un pilote de niveau supérieur.

[in] StackSize

Spécifie le nombre d’emplacements de pile à allouer pour les IRP associés. La valeur doit être au moins égale à stackSize de l’objet de périphérique du pilote inférieur suivant, mais l’IRP associé peut avoir un emplacement de pile supplémentaire pour l’appelant.

Valeur retournée

IoMakeAssociatedIrp retourne un pointeur vers l’IRP associé ou retourne un pointeur NULL si un IRP ne peut pas être alloué.

Remarques

Seul un pilote de niveau supérieur peut appeler cette routine.

Le gestionnaire d’E/S effectue automatiquement la master IRP lorsque les pilotes inférieurs ont terminé tous les IP associés tant que l’appelant n’a pas défini sa routine IoCompletion dans un IRP associé et renvoyé STATUS_MORE_PROCESSING_REQUIRED à partir de sa routine IoCompletion. Dans ces circonstances, l’appelant doit remplir explicitement les master IRP lorsque ce pilote a déterminé que tous les IRP associés ont été terminés.

Seul le master IRP est associé à un thread ; les IRP associés ne le sont pas. Pour cette raison, le gestionnaire d’E/S ne peut pas appeler les routines Cancel pour les IRP associés lorsqu’un thread se termine. Lorsque le thread de l’IRP master se ferme, le gestionnaire d’E/S appelle la routine Cancel du master IRP. La routine Cancel est chargée de rechercher tous les IRP associés et d’appeler IoCancelIrp pour les annuler.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible à partir de Windows 2000.
Plateforme cible	Universal
En-tête	ntddk.h (inclure Ntddk.h)
Bibliothèque	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= DISPATCH_LEVEL