IoInitializeIrp-Funktion (wdm.h)

Artikel
03/01/2024

Die IoInitializeIrp-Routine initialisiert einen bestimmten IRP, der vom Aufrufer zugewiesen wurde.

Syntax

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

Parameter

[in, out] Irp

Zeiger auf den zu initialisierenden IRP.

[in] PacketSize

Gibt die Größe des IRP in Bytes an.

[in] StackSize

Gibt die Anzahl der Stapelspeicherorte im IRP an.

Rückgabewert

Keine

Bemerkungen

Treiber verwenden IoInitializeIrp , um IRPs zu initialisieren, die dem Treiber als roher Arbeitsspeicher zugeordnet sind. Verwenden Sie IoInitializeIrp nicht, um eine von IoAllocateIrp zugewiesene IRP zu initialisieren. IoAllocateIrp initialisiert automatisch die Mitglieder des IRP.

Treiber können IoInitializeIrp nur unter bestimmten Umständen zum erneuten Initialisieren eines IRP zur Wiederverwendung verwenden. Weitere Informationen finden Sie unter Wiederverwendung von IRPs .

Wenn der Treiber eine MDL mit dem zugewiesenen IRP verknüpft, ist der Treiber für die Freigabe der MDL verantwortlich, wenn die IRP abgeschlossen ist.

Ein Treiber auf mittlerer oder höchster Ebene kann auch IoBuildDeviceIoControlRequest, IoBuildAsynchronousFsdRequest oder IoBuildSynchronousFsdRequest aufrufen, um Anforderungen einzurichten, die an Treiber auf niedrigerer Ebene gesendet werden. Nur ein Treiber der höchsten Ebene kann IoMakeAssociatedIrp aufrufen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar ab Windows 2000.
Zielplattform	Universell
Header	wdm.h (einschließlich Wdm.h, Ntddk.h, Ntifs.h)
Bibliothek	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= DISPATCH_LEVEL
DDI-Complianceregeln	HwStorPortProhibitedDDIs(storport), IoReuseIrp(wdm)