Fonction IoAllocateIrp (wdm.h)

Article
02/29/2024

La routine IoAllocateIrp alloue un IRP, en fonction du nombre d’emplacements de pile d’E/S pour chaque pilote en couche sous l’appelant et, éventuellement, pour l’appelant. Voir aussi IoAllocateIrpEx.

Syntaxe

PIRP IoAllocateIrp(
  [in] CCHAR   StackSize,
  [in] BOOLEAN ChargeQuota
);

Paramètres

[in] StackSize

Spécifie le nombre d’emplacements de pile d’E/S à allouer pour l’IRP. Cette valeur doit être au moins égale à stackSize de l’objet de périphérique du pilote inférieur suivant, mais peut être supérieure à cette valeur. Le pilote appelant n’a pas besoin d’allouer un emplacement de pile dans l’IRP pour lui-même.

[in] ChargeQuota

Si vous définissez cette valeur sur TRUE , la mémoire allouée pour l’IRP est facturée sur le quota pour le processus en cours. Doit être défini sur FALSE par les pilotes intermédiaires. Cela peut être défini sur TRUE uniquement par les pilotes de niveau supérieur appelés dans le contexte du thread à l’origine de la demande d’E/S pour laquelle le pilote alloue un autre IRP.

Valeur retournée

IoAllocateIrp retourne un pointeur vers un IRP, qui a été alloué à partir de l’espace système non paginé, ou NULL si un IRP n’a pas pu être alloué.

Remarques

La routine IoAllocateIrp n’associe pas l’IRP à un thread. Le pilote d’allocation doit libérer l’IRP au lieu de le renvoyer au gestionnaire d’E/S.

Un pilote intermédiaire ou de niveau supérieur peut appeler IoAllocateIrp pour créer des irps pour les demandes qu’il envoie aux pilotes de niveau inférieur. Un tel pilote doit initialiser l’IRP et doit définir sa routine IoCompletion dans l’IRP qu’il crée afin que l’appelant puisse se débarrasser de l’IRP lorsque les pilotes de niveau inférieur ont terminé le traitement de la demande.

IoAllocateIrp initialise automatiquement les membres de l’IRP. N’utilisez pas IoInitializeIrp pour initialiser l’IRP avant sa première utilisation. (Vous pouvez utiliser IoInitializeIrp pour réutiliser un IRP que vous avez déjà utilisé dans certaines circonstances particulières. Pour plus d’informations, consultez Réutilisation des IRP .)

Un pilote intermédiaire ou de niveau supérieur peut également appeler IoBuildDeviceIoControlRequest, IoBuildAsynchronousFsdRequest ou IoBuildSynchronousFsdRequest pour configurer les demandes qu’il envoie aux pilotes de niveau inférieur. Seul un pilote de niveau supérieur peut appeler IoMakeAssociatedIrp.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible à partir de Windows 2000.
Plateforme cible	Universal
En-tête	wdm.h (inclure Wdm.h, Ntddk.h, Ntifs.h)
Bibliothèque	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= DISPATCH_LEVEL
Règles de conformité DDI	ForwardedAtBadIrqlAllocate(wdm),HwStorPortProhibitedDDDIs(storport),IoAllocateComplete(wdm), IoAllocateForward(wdm), IoAllocateFree(wdm), IoAllocateIrpSignalEventInCompletion(wdm), IoAllocateIrpSignalEventInCompletion2(wdm), IoAllocateIrpSignalEventInCompletion3(wdm), IoAllocateIrpSignalEventInCompletionTimeout(wdm), IoFreeIrp(storport), IoReuseIrp(wdm), MarkPower(wdm), MarkPowerDown(wdm), MarkQueryRelations(wdm), MarkStartDevice(wdm), SpNoWait(storport), StorPortStartIo(storport)