FltRegisterForDataScan 関数 (fltkernel.h)

[アーティクル]
01/23/2024

FltRegisterForDataScan ルーチンを使用すると、ミニフィルターインスタンスにアタッチされているボリュームのデータスキャンが可能になります。

構文

NTSTATUS FLTAPI FltRegisterForDataScan(
  [in] PFLT_INSTANCE Instance
);

パラメーター

[in] Instance

データスキャンに登録するミニフィルタードライバーインスタンスの不透明なインスタンスポインター。

戻り値

FltRegisterForDataScan は 、次のいずれかのSTATUS_SUCCESSまたは適切な NTSTATUS 値を返します。

リターンコード	説明
STATUS_NOT_SUPPORTED	フィルターマネージャーでは、このインスタンスにアタッチされているボリュームのデータスキャンはサポートされていません。

注釈

データスキャンを実行するミニフィルターでは、FltCreateSectionForDataScan を呼び出す前に FltRegisterForDataScan を呼び出して、そのボリュームをスキャン用に登録する必要があります。ミニフィルターは、ウイルス検出、暗号化、圧縮など、さまざまな理由でデータスキャンを実行します。

注意

FltRegisterForDataScan がSTATUS_NOT_SUPPORTEDを返した場合でも、FsRtlCreateSectionForDataScan を呼び出すことで、ミニフィルターでデータスキャン用のセクションを作成できます。ただし、 FsRtlCreateSectionForDataScan によって作成されたセクションへのアクセスは同期されず、発生した競合解決を処理するのは呼び出し元のミニフィルターの責任です。このようなミニフィルターでは、セクションの競合が発生したときに呼び出すことができる PFLT_SECTION_CONFLICT_NOTIFICATION_CALLBACK コールバックルーチンを実装して登録する必要があります。

要件

要件	値
サポートされている最小のクライアント	Windows 8
対象プラットフォーム	ユニバーサル
Header	fltkernel.h (Fltkernel.h を含む)
Library	FltMgr.lib
[DLL]	Fltmgr.sys
IRQL	<= APC_LEVEL