Fonction IoInitializeIrp (wdm.h)

Article
02/27/2024

La routine IoInitializeIrp initialise un IRP donné qui a été alloué par l’appelant.

Syntaxe

void IoInitializeIrp(
  [in, out] PIRP   Irp,
  [in]      USHORT PacketSize,
  [in]      CCHAR  StackSize
);

Paramètres

[in, out] Irp

Pointeur vers l’IRP à initialiser.

[in] PacketSize

Spécifie la taille en octets de l’IRP.

[in] StackSize

Spécifie le nombre d’emplacements de pile dans l’IRP.

Valeur de retour

None

Remarques

Les pilotes utilisent IoInitializeIrp pour initialiser les IRP que le pilote a alloués en mémoire brute. N’utilisez pas IoInitializeIrp pour initialiser un IRP alloué par IoAllocateIrp. IoAllocateIrp initialise automatiquement les membres de l’IRP.

Les pilotes peuvent utiliser IoInitializeIrp pour réinitialiser un IRP en vue d’une réutilisation uniquement dans certaines circonstances. Pour plus d’informations, consultez Réutilisation des IRPs .

Si le pilote associe une MDL au IRP qu’il a alloué, il est responsable de la libération du MDL une fois l’IRP terminée.

Un pilote intermédiaire ou de niveau supérieur peut également appeler IoBuildDeviceIoControlRequest, IoBuildAsynchronousFsdRequest ou IoBuildSynchronousFsdRequest pour configurer les requêtes 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	HwStorPortProhibitedDDIs(storport),IoReuseIrp(wdm)