FltCreateSectionForDataScan 関数 (fltkernel.h)

FltCreateSectionForDataScan ルーチンは、ファイルのセクション オブジェクトを作成します。 フィルター マネージャーは、必要に応じて、作成されたセクションと I/O を同期できます。

構文

NTSTATUS FLTAPI FltCreateSectionForDataScan(
  [in]            PFLT_INSTANCE      Instance,
  [in]            PFILE_OBJECT       FileObject,
  [in]            PFLT_CONTEXT       SectionContext,
  [in]            ACCESS_MASK        DesiredAccess,
  [in, optional]  POBJECT_ATTRIBUTES ObjectAttributes,
  [in, optional]  PLARGE_INTEGER     MaximumSize,
  [in]            ULONG              SectionPageProtection,
  [in]            ULONG              AllocationAttributes,
  [in]            ULONG              Flags,
  [out]           PHANDLE            SectionHandle,
  [out]           PVOID              *SectionObject,
  [out, optional] PLARGE_INTEGER     SectionFileSize
);

パラメーター

[in] Instance

コンテキストを取得するミニフィルター ドライバー インスタンスの不透明なインスタンス ポインター。

[in] FileObject

開いているファイルのファイル オブジェクト。 セクション オブジェクトは、指定されたファイルによってサポートされます。 このパラメーターは必須であり、NULL にすることはできません。

[in] SectionContext

以前に割り当てられたセクション コンテキストへのポインター。

[in] DesiredAccess

次の ACCESS_MASK フラグの 1 つ以上としてのセクション オブジェクトのアクセスの種類。

[in, optional] ObjectAttributes

オブジェクト名とその他の属性を指定する省略可能な OBJECT_ATTRIBUTES 構造体へのポインター。 この構造体を初期化するには、InitializeObjectAttributes マクロを使用します。

[in, optional] MaximumSize

このパラメーターは、将来使用するために予約されています。

[in] SectionPageProtection

セクション内の各ページに配置する保護。 次のいずれかの値を指定します。 このパラメーターは必須であり、0 にすることはできません。

[in] AllocationAttributes

SEC_XXX フラグのビットマスクによって、セクションの割り当て属性が決まります。 次の値のうち 1 つ以上を指定します。 このパラメーターは必須であり、0 にすることはできません。

[in] Flags

このパラメーターは、将来使用するために予約されています。

[out] SectionHandle

セクションへの不透明なハンドルを受け取る呼び出し元によって割り当てられた変数へのポインター。 既定では、セクション ハンドルはユーザー ハンドルです。 呼び出し元がカーネル ハンドルを必要とする場合は、OBJ_KERNEL_HANDLE フラグが設定された ObjectAttributes パラメーター内の初期化された OBJECT_ATTRIBUTES 構造体へのポインターを渡す必要があります。

[out] SectionObject

セクション オブジェクトへの不透明なポインターを受け取る呼び出し元によって割り当てられた変数へのポインター。

[out, optional] SectionFileSize

セクション オブジェクトの作成時にファイルのサイズ (バイト単位) を受け取る呼び出し元によって割り当てられた変数へのポインター。 このパラメーターは省略可能であり、NULL にすることができます。

戻り値

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

備考

FltCreateSectionForDataScan呼び出す前に、ミニフィルターは、まず FltRegisterForDataScan呼び出して、データ スキャン用のボリュームを登録する必要があります。 他のフィルター コンテキスト要素と同様に、SectionContext は、最初に FltAllocateContext割り当てられます。

FltCreateSectionForDataScan 、FltCreateSectionForDataScan が呼び出されたスレッドのプロセス ハンドル テーブルに、オブジェクト (SectionHandle) へのハンドルを挿入します。

ハンドルには、ユーザー ハンドルまたはカーネル ハンドルのいずれかを指定できます。 ObjectAttributes が指 OBJECT_ATTRIBUTES 構造体に設定されたOBJ_KERNEL_HANDLEで作成されたハンドルはカーネル ハンドルであり、カーネル モードからのみアクセスできます。 OBJ_KERNEL_HANDLE フラグなしで作成されたハンドルは、ユーザー またはカーネル モードからアクセスできるユーザー ハンドルです。 フィルターは、ユーザー ハンドルを作成し、処理のためにユーザー モード アプリケーションに渡すことができます。 たとえば、ウイルス スキャン エンジンは、ユーザー モード アプリケーションに存在し、ファイル システム フィルターからユーザー ハンドルをフィードできます。

セクションを開いたままにすると、現在のファイル I/O と互換性がない場合があります。 特に、キャッシュの消去をトリガーするファイル I/O では、セクションが開いているためにキャッシュの消去が禁止されている場合、キャッシュの一貫性が低下する可能性があります。 ミニフィルターは、これらのイベントの通知にオプションのコールバック ルーチンを提供できます。 ミニフィルター ドライバーは、これらの通知を受信する PFLT_SECTION_CONFLICT_NOTIFICATION_CALLBACK を実装します。 FLT_REGISTRATION の SectionNotificationCallback メンバーがミニフィルターの登録時にこのコールバック ルーチンに設定されている場合、競合通知が有効になります。 通知を受信すると、セクションを閉じて、競合する I/O 操作を続行できます。

このルーチンによって作成されたセクション オブジェクトが不要になった場合は、ZwClose ルーチンを呼び出してセクション オブジェクトのハンドル (SectionHandle) を閉じ、ObDereferenceObject ルーチンを呼び出してセクション オブジェクト自体 (SectionObject) を逆参照してください。

マップされたセクションとメモリのビューの作成の概要については、「Section Objects and Views」を参照してください。 また、Microsoft Windows SDK の CreateFileMapping ルーチンのドキュメントも参照してください。

必要条件

関連項目

ACCESS_MASK

ccPurgeCacheSection を する

FLT_REGISTRATION

FltAllocateContext の

FltCloseSectionForDataScan の

FltRegisterForDataScan の

ObDereferenceObject の

PFLT_SECTION_CONFLICT_NOTIFICATION_CALLBACK

ZwClose

ZwCreateSection