FltIsIoRedirectionAllowedForOperation-Funktion (fltkernel.h)

Artikel
02/29/2024

Die FltIsIoRedirectionAllowedForOperation-Routine bestimmt, ob E/A von der Filter-instance, die der angegebenen FLT_CALLBACK_DATA-Struktur zugeordnet ist, zum angegebenen Filter instance umgeleitet werden kann.

Syntax

NTSTATUS FLTAPI FltIsIoRedirectionAllowedForOperation(
  [in]            PFLT_CALLBACK_DATA Data,
  [in]            PFLT_INSTANCE      TargetInstance,
  [out]           PBOOLEAN           RedirectionAllowedThisIo,
  [out, optional] PBOOLEAN           RedirectionAllowedAllIo
);

Parameter

[in] Data

Eine FLT_CALLBACK_DATA-Struktur , die den E/A-Vorgang darstellt.

[in] TargetInstance

Ein Filter instance auf dem Zielgerätestapel.

[out] RedirectionAllowedThisIo

Der Wert TRUE, wenn diese E/A an den Zielgerätestapel umgeleitet werden kann, indem der Filter geändert instance referenziert wird.

[out, optional] RedirectionAllowedAllIo

Dieser optionale Parameter hat den Wert TRUE, wenn alle E/A-Vorgänge für den Gerätestapel, auf den der E/A-Vorgang ausgegeben wird, an das Zielgerät umgeleitet werden können, indem der Filter geändert instance referenziert wird, andernfalls FALSE.

Rückgabewert

Ein NTSTATUS-Wert von STATUS_SUCCESS für erfolg oder STATUS_NOT_SUPPORTED, wenn die Umleitung nicht unterstützt wird.

Hinweise

Ein E/A-Vorgang ist einer FLT_CALLBACK_DATA-Struktur zugeordnet. Diese Struktur enthält einen Verweis auf ein PFLT_IO_PARAMETER_BLOCK-Objekt , das einen Verweis auf die FLT_INSTANCE des Minifilters enthält, der dem E/A-Vorgang zugeordnet ist.

Wenn RedirectionAllowedAUF TRUE festgelegt ist, kann der Minifilter E/A umleiten, indem er diese instance in ein neues Ziel instance ändert.

Wenn RedirectionAllowedAUF FALSE festgelegt ist, muss der Minifilter ein neues Rückrufdatenobjekt zuordnen, um E/A im Zielstapel auszulösen oder FltAdjustDeviceStackSizeForIoRedirection aufzurufen, um die Größe des Quellgerätestapels zu erhöhen.

Hinweis Minifilter sollten den Verweis auf die FLT_INSTANCE nicht ändern, bevor überprüft wird, ob die Umleitung auf diese Weise erfolgen kann. Verwenden Sie FltIsIoRedirectionAllowedForOperation oder FltIsIoRedirectionAllowed.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Windows 7 und höheren Versionen des Windows-Betriebssystems.
Zielplattform	Universell
Header	fltkernel.h (fltKernel.h einschließen)
Bibliothek	FltMgr.lib
DLL	Fltmgr.sys
IRQL	<=DISPATCH_LEVEL

Weitere Informationen

FLT_CALLBACK_DATA

FLT_IO_PARAMETER_BLOCK

FltAdjustDeviceStackSizeForIoRedirection

FltIsIoRedirectionAllowed

Freigeben über