FLT_RELATED_CONTEXTS_EX 構造体 (fltkernel.h)

[アーティクル]
08/07/2023

FLT_RELATED_CONTEXTS_EX構造体には、I/O 操作に関連付けられているオブジェクトのミニフィルタードライバーのコンテキストが含まれています。この構造体は、セクションコンテキストを含むようにFLT_RELATED_CONTEXTS構造体を拡張します。

構文

typedef struct _FLT_RELATED_CONTEXTS_EX {
  PFLT_CONTEXT VolumeContext;
  PFLT_CONTEXT InstanceContext;
  PFLT_CONTEXT FileContext;
  PFLT_CONTEXT StreamContext;
  PFLT_CONTEXT StreamHandleContext;
  PFLT_CONTEXT TransactionContext;
  PFLT_CONTEXT SectionContext;
} FLT_RELATED_CONTEXTS_EX, *PFLT_RELATED_CONTEXTS_EX;

メンバー

VolumeContext

FLT_RELATED_OBJECTS構造体の Volume メンバーが指すボリュームのミニフィルターのコンテキストへの不透明なポインター。

InstanceContext

FLT_RELATED_OBJECTS構造体の Instance メンバーが指すインスタンスのミニフィルタードライバーのコンテキストへの不透明なポインター。

FileContext

FLT_RELATED_OBJECTS構造体の FileObject メンバーが指すストリームハンドルのミニフィルタードライバーのファイルごとのコンテキストへの不透明なポインター。

StreamContext

FLT_RELATED_OBJECTS構造体の FileObject メンバーが指すストリームハンドルのミニフィルターのストリームコンテキストへの不透明なポインター。

StreamHandleContext

FLT_RELATED_OBJECTS構造体の FileObject メンバーが指すストリームハンドルのミニフィルターのストリームハンドルコンテキストへの不透明なポインター。

TransactionContext

FLT_RELATED_OBJECTS構造体の Transaction メンバーが指すトランザクションのミニフィルターのトランザクションコンテキストへの不透明なポインター。

SectionContext

FLT_RELATED_OBJECTS構造体の FileObject メンバーが指すストリームハンドルのミニフィルターのセクションコンテキストへの不透明なポインター。

注釈

FLT_RELATED_CONTEXTS_EX構造体には、I/O 操作またはインスタンスのセットアップまたは破棄操作に関連付けられているオブジェクトのミニフィルタードライバーのコンテキストが含まれています。

ミニフィルタードライバーは、 FLT_RELATED_CONTEXTS_EX 構造体を使用して、特定の操作の複数のコンテキストを取得します。これを行うために、ミニフィルタードライバーは空の FLT_RELATED_CONTEXTS_EX 構造体を割り当て、それに対するポインターを Contexts パラメーターとして FltGetContextsEx に渡します。

ミニフィルターでは、この構造体を使用して、特定の操作の複数のコンテキストを解放することもできます。これを行うために、ミニフィルタードライバーは、Contexts パラメーターとして FLT_RELATED_CONTEXTS_EX へのポインターを FltReleaseContextsEx に渡します。

コンテキストの使用の詳細については、 FltAllocateContext のリファレンスエントリを参照してください。