FLT_RELATED_OBJECTS構造体 (fltkernel.h)

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

FLT_RELATED_OBJECTS構造体には、操作に関連付けられているオブジェクトの不透明なポインターが含まれています。

構文

typedef struct _FLT_RELATED_OBJECTS {
  USHORT        Size;
  USHORT        TransactionContext;
  PFLT_FILTER   Filter;
  PFLT_VOLUME   Volume;
  PFLT_INSTANCE Instance;
  PFILE_OBJECT  FileObject;
  PKTRANSACTION Transaction;
} FLT_RELATED_OBJECTS, *PFLT_RELATED_OBJECTS;

メンバーズ

Size

FLT_RELATED_OBJECTS構造体のサイズ (バイト単位)。

TransactionContext

Transaction メンバーが NULL されていない場合、トランザクションミニバージョン ID 値を含む不透明なメンバー。 Transaction が NULL 場合、TransactionContext の値は未定義です。

Filter

操作に対してコールバックルーチンが呼び出されているミニフィルタードライバーの不透明なフィルターポインター。このポインターは、ミニフィルタードライバーを一意に識別し、ミニフィルタードライバーが読み込まれている限り一定のままになります。

Volume

操作に関連付けられているボリュームの不透明なボリュームポインター。このポインターは、ボリュームを一意に識別し、ボリュームデバイススタックの有効期間にわたって一定のままになります。

Instance

操作に関連付けられているミニフィルタードライバーインスタンスの不透明なインスタンスポインター。このポインターは、インスタンスを一意に識別し、インスタンスがボリュームにアタッチされている限り一定のままになります。

FileObject

操作のファイルオブジェクト (存在する場合) へのポインター。

Transaction

Windows Vista 以降では、このメンバーは、操作に関連付けられているトランザクションへの不透明なトランザクションポインターです。このメンバーの値が NULL でない場合、操作はトランザクションの一部になります。このメンバーの値が NULL 場合、操作はトランザクションの一部になりません。 Windows Vista より前の Windows オペレーティングシステムでは、このメンバーの値は常に NULL されます。

備考

FLT_RELATED_OBJECTS構造体はフィルターマネージャーによって割り当てられ、I/O 操作またはインスタンスのセットアップまたは破棄操作に関連付けられているオブジェクトの不透明なポインターが含まれています。

FLT_RELATED_OBJECTS構造体の内容は、フィルターマネージャーによって設定されます。ミニフィルタードライバーは、この構造体の内容を直接変更することはできません。ただし、ミニフィルタードライバーが、操作の FLT_IO_PARAMETER_BLOCK 構造体の I/O 操作のターゲットインスタンスまたはターゲットファイルオブジェクトを変更する場合、フィルターマネージャーは、下位ミニフィルタードライバーに渡されるFLT_RELATED_OBJECTS構造体の対応する インスタンス または FileObject メンバーの値を変更します。詳細については、「I/O 操作のパラメーターの変更」を参照してください。

ミニフィルタードライバーは、FltObjects 次のコールバックルーチン型への入力パラメーターとして、FLT_RELATED_OBJECTS構造体へのポインターを受け取ります。

PFLT_POST_OPERATION_CALLBACK

PFLT_PRE_OPERATION_CALLBACK

PFLT_INSTANCE_SETUP_CALLBACK

PFLT_INSTANCE_QUERY_TEARDOWN_CALLBACK

PFLT_INSTANCE_TEARDOWN_CALLBACK

FLT_RELATED_OBJECTS構造体内のオブジェクトのミニフィルタードライバーのコンテキストへのポインターを取得するには、FltGetContexts 呼び出します。

Notetypedef CONST struct _FLT_RELATED_OBJECTS *PCFLT_RELATED_OBJECTS;