IoMakeAssociatedIrp-Funktion (ntddk.h)

Artikel
02/26/2024

Diese Routine ist für die Verwendung durch Dateisysteme und Dateisystemfiltertreiber reserviert. Die IoMakeAssociatedIrp-Routine ordnet und initialisiert eine IRP, die einer master IRP zugeordnet wird, die an einen Treiber der höchsten Ebene gesendet wird, sodass der Aufrufer die ursprüngliche Anforderung aufteilen und zugehörige IRPs an Treiber auf niedrigerer Ebene senden kann.

Syntax

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

Parameter

[in] Irp

Zeiger auf die master IRP, die für die Dispatch-Routine eines Treibers auf höchster Ebene eingegeben wurde.

[in] StackSize

Gibt die Anzahl der Stapelspeicherorte an, die für die zugeordnete IRP zugewiesen werden sollen. Der Wert muss mindestens gleich dem StackSize des Geräteobjekts des nächstniedrigen Treibers sein, aber die zugeordnete IRP kann einen zusätzlichen Stapelspeicherort für den Aufrufer aufweisen.

Rückgabewert

IoMakeAssociatedIrp gibt einen Zeiger auf die zugeordnete IRP oder einen NULL-Zeiger zurück, wenn ein IRP nicht zugeordnet werden kann.

Hinweise

Nur ein Treiber der obersten Ebene kann diese Routine aufrufen.

Der E/A-Manager schließt die master IRP automatisch ab, wenn niedrigere Treiber alle zugehörigen IRPs abgeschlossen haben, solange der Aufrufer seine IoCompletion-Routine in einem zugehörigen IRP nicht festgelegt und STATUS_MORE_PROCESSING_REQUIRED aus seiner IoCompletion-Routine zurückgegeben hat. Unter diesen Umständen muss der Aufrufer die master IRP explizit abschließen, wenn dieser Treiber festgestellt hat, dass alle zugehörigen IRPs abgeschlossen wurden.

Nur die master IRP ist einem Thread zugeordnet, zugeordnete IRPs nicht. Aus diesem Grund kann der E/A-Manager keine Cancel-Routinen für zugeordnete IRPs aufrufen, wenn ein Thread beendet wird. Wenn der Thread des master IRP beendet wird, ruft der E/A-Manager die master Abbrechen-Routine von IRP auf. Die Cancel-Routine ist dafür verantwortlich, alle zugehörigen IRPs aufzuspüren und IoCancelIrp aufzurufen, um sie abzubrechen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar ab Windows 2000.
Zielplattform	Universell
Header	ntddk.h (include Ntddk.h)
Bibliothek	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= DISPATCH_LEVEL