KsForwardIrp-Funktion (ks.h)

Die KsForwardIrp--Funktion leitet einen IRP an den angegebenen Treiber weiter, nachdem der nächste Stapelspeicherort initialisiert und das Dateiobjekt festgelegt wurde.

Syntax

KSDDKAPI NTSTATUS KsForwardIrp(
  [in] PIRP         Irp,
  [in] PFILE_OBJECT FileObject,
  [in] BOOLEAN      ReuseStackLocation
);

Parameter

[in] Irp

Gibt das IRP an, das an den angegebenen Treiber weitergeleitet wird.

[in] FileObject

Gibt das Dateiobjekt an, mit dem der nächste Stapel initialisiert werden soll.

[in] ReuseStackLocation

Gibt die neue Stapelposition an.

Rückgabewert

Die KsForwardIrp--Funktion gibt das Ergebnis des IoCallDriver-zurück oder gibt einen ungültigen Status zurück, wenn keine weitere Stapeltiefe verfügbar ist.

Bemerkungen

Verwenden Sie die KsForwardIrp--Funktion, wenn nur der FileObject Parameter des weitergeleiteten IRP geändert wird, wenn die aktuellen Stapelparameter an den nächsten Stapelspeicherort kopiert werden. Die Funktion überprüft, ob ein neuer Stapelspeicherort vorhanden ist, in den kopiert werden soll, bevor Sie versuchen, zu kopieren. Wenn keine neue Stapelposition vorhanden ist, wird das IRP mit STATUS_INVALID_DEVICE_REQUEST abgeschlossen.

Anforderungen