IO_DRIVER_CREATE_CONTEXT構造体 (ntddk.h)

[アーティクル]
12/21/2024

IO_DRIVER_CREATE_CONTEXT構造体は、IoCreateFileEx および FltCreateFileEx2 ルーチンに追加のパラメーターを渡すために使用されます。この構造体は省略可能です。

IoCreateFileEx ルーチンはレガシフィルタードライバーによって使用され、FltCreateFileEx2 ルーチンはミニフィルタードライバーによって使用されます。

構文

typedef struct _IO_DRIVER_CREATE_CONTEXT {
  CSHORT               Size;
  struct _ECP_LIST     *ExtraCreateParameter;
  PVOID                DeviceObjectHint;
  PTXN_PARAMETER_BLOCK TxnParameters;
  PESILO               SiloContext;
} IO_DRIVER_CREATE_CONTEXT, *PIO_DRIVER_CREATE_CONTEXT;

メンバーズ

Size

IoInitializeDriverCreateContext ルーチンによって初期化された読み取り専用メンバー。

ExtraCreateParameter

追加の create パラメーター (ECP) エントリの一覧を含む、ECP_LIST 構造体へのポインター。重要な情報については、次の解説セクションを参照してください。

DeviceObjectHint

IO_DRIVER_CREATE_CONTEXTを使用して、FltCreateFileEx2 ルーチンに追加の作成パラメーターを渡す場合、このメンバーは NULLする必要があります。

IO_DRIVER_CREATE_CONTEXTを使用して、IoCreateFileEx ルーチンに追加の作成パラメーターを渡す場合、このメンバーは作成要求の送信先となるデバイスオブジェクトへのポインターです。デバイスオブジェクトは、ファイルまたはディレクトリが存在するボリュームのファイルシステムドライバースタック内のレガシフィルターまたはファイルシステムデバイスオブジェクトである必要があります。 IoCreateFileEx の場合、このパラメーターは省略可能であり、NULLできます。このパラメーターが NULL場合、要求はドライバースタックの上部にあるデバイスオブジェクトに送信されます。

TxnParameters

作成操作に関連付けるトランザクションへのポインター。このメンバーの値がトランザクションへの有効なポインターである場合、作成操作はトランザクションの一部になります。このメンバーの値が NULL場合、作成操作はトランザクションの一部になりません。

SiloContext

ファイルが存在するコンテナー。このメンバーは、Windows 10 バージョン 1607 で導入されました。

備考

IO_DRIVER_CREATE_CONTEXT構造体は、ページプールまたは非ページプールから割り当てることができます。 IoInitializeDriverCreateContext ルーチンは、構造体を使用する前にIO_DRIVER_CREATE_CONTEXT構造体を初期化する必要があります。

IO_DRIVER_CREATE_CONTEXT構造体のメンバー (Size メンバーを除く) は、IoCreateFileEx および FltCreateFileEx2 ルーチン追加パラメーターとして機能します。 IoCreateFileEx と FltCreateFileEx2 ルーチンのインターフェイスに関して、次の情報が役立つ場合があります。

ECP_LIST構造体には、追加の create パラメーター (ECP) エントリの一覧が含まれています。 ECP リスト (ECP_LIST構造体) 内の各 ECP エントリ (ECP コンテキスト構造) は、IoCreateFileEx と FltCreateFileEx2するための追加の作成パラメーターとして機能します。

作成操作の一部として ECP を指定するには、正しいルーチンを使用して、IO_DRIVER_CREATE_CONTEXT構造体の ExtraCreateParameter メンバーを初期化します。
- レガシフィルタードライバーの場合、FsRtlAllocateExtraCreateParameterList ルーチンを使用して、ECP_LIST構造体のメモリプールを割り当てる必要があります。オペレーティングシステムは、ECP_LIST構造を自動的に解放しません。代わりに、ECP_LIST構造体が割り当てられると、最終的には、FsRtlFreeExtraCreateParameterList ルーチンを使用して解放する必要があります。
- ミニフィルタードライバーの場合、fltAllocateExtraCreateParameterList ルーチン使用して、ECP_LIST構造体のメモリプールを割り当てる必要があります。オペレーティングシステムは、ECP_LIST構造を自動的に解放しません。代わりに、ECP_LIST構造体が割り当てられると、最終的には、FltFreeExtraCreateParameterList ルーチンを使用して解放する必要があります。
ECP を使用する場合は、適切なルーチンを使用して作成、操作、解放する必要があります。たとえば、ミニフィルタードライバーは、FltInsertExtraCreateParameter ルーチンを使用して、ECP リストに ECP エントリを挿入します。次の「」セクションでは、これらの必要なルーチンの多くを一覧表示します。

IoCreateFileEx または FltCreateFileEx2の呼び出しから戻ると、ECP リストは変更されず、新しい作成操作の呼び出しまたは FltCreateFileEx 2 追加のに渡すことができます。
トランザクションのコンテキストでファイルを作成または開くには、IO_DRIVER_CREATE_CONTEXT構造体の TxnParameters メンバーを、IoGetTransactionParameterBlock ルーチンによって返される値に設定します。

必要条件

要件	価値
ヘッダー	ntddk.h (Ntddk.h、Ntifs.h、Fltkernel.h を含む)

次の方法で共有

IO_DRIVER_CREATE_CONTEXT構造体 (ntddk.h)

構文

メンバーズ

備考

必要条件

関連項目

フィードバック

その他のリソース