FltIsIoRedirectionAllowed 関数 (fltkernel.h)

FltIsIoRedirectionAllowed ルーチンは、指定したソース フィルター インスタンスから別の指定されたフィルター インスタンスに I/O をリダイレクトできるかどうかを決定します。

構文

NTSTATUS FLTAPI FltIsIoRedirectionAllowed(
  [in]  PFLT_INSTANCE SourceInstance,
  [in]  PFLT_INSTANCE TargetInstance,
  [out] PBOOLEAN      RedirectionAllowed
);

パラメーター

[in] SourceInstance

ソース デバイス スタック上のフィルター インスタンス。

[in] TargetInstance

ターゲット デバイス スタック上のフィルター インスタンス。

[out] RedirectionAllowed

参照されるフィルター インスタンスを変更することで、ソース デバイス スタックへのすべての I/O をターゲット デバイス スタックにリダイレクトできる場合は TRUE 、それ以外の場合 は FALSE。

戻り値

成功にSTATUS_SUCCESS NTSTATUS 値。リダイレクトがサポートされていない場合はSTATUS_NOT_SUPPORTED。

注釈

I/O 操作は 、FLT_CALLBACK_DATA 構造体に関連付けられます。 この構造体には 、I /O 操作に関連付けられているミニフィルターのFLT_INSTANCEへの参照を含む、PFLT_IO_PARAMETER_BLOCK オブジェクトへの参照が含まれています。

RedirectAllowed が TRUE の場合、ミニフィルターは、そのインスタンスを新しいターゲット インスタンスに変更することで I/O をリダイレクトできます。

RedirectAllowed が FALSE の場合、ミニフィルターは、ターゲット スタックで I/O を発行する新しいコールバック データ オブジェクトを割り当てるか、FltAdjustDeviceStackSizeForIoRedirection を呼び出してソース デバイス スタックのサイズを大きくする必要があります。

メモ ミニフィルターは、リダイレクトをこのように実行できることを確認する前に、FLT_INSTANCEへの参照を変更しないでください。 FltIsIoRedirectionAllowedForOperation または FltIsIoRedirectionAllowed を使用します。

 

要件

要件	値
サポートされている最小のクライアント	Windows 7 以降のバージョンの Windows オペレーティング システムで使用できます。
対象プラットフォーム	ユニバーサル
Header	fltkernel.h (FltKernel.h を含む)
Library	FltMgr.lib
[DLL]	Fltmgr.sys
IRQL	<=DISPATCH_LEVEL

こちらもご覧ください

FLT_CALLBACK_DATA

FLT_IO_PARAMETER_BLOCK

FltAdjustDeviceStackSizeForIoRedirection

FltIsIoRedirectionAllowedForOperation