[!NOTE]
一部の情報はリリース前の製品に関する事項であり、正式版がリリースされるまでに大幅に変更される可能性があります。 Microsoft はここに示されている情報について、明示か黙示かを問わず、一切保証しません。
このページでは、システム定義の追加作成パラメーター (ECP) について一覧を表示し、説明します。 The operating system defines these ECPs in the Ntifs.h header file.
These system-defined ECPs attach the specified extra information to the IRP_MJ_CREATE operation on a file. ファイル システム スタックの要素は、追加情報に対して ECP のクエリを実行できます。
Typically, a filter that processes the IRP_MJ_CREATE operation on a file and then passes the file down to filters below it must not attach and spoof any of the system-defined ECPs to the IRP_MJ_CREATE operation on the file.
Similarly, a kernel-mode driver that processes and issues IRP_MJ_CREATE operations on files must not attach and spoof any system-defined ECPs to the IRP_MJ_CREATE operations on the files.
フィルター ドライバーでは、システム定義の ECP を読み取り専用と見なす必要があります。 情報の取得にのみ使用する必要があります。
フィルター ドライバーが次のシステム定義の ECP のいずれかを添付することを制限する 1 つの例外が、フィルター ドライバーで階層化ファイル システムを実装する場合です。 It does this by owning file objects and by issuing its own IRP_MJ_CREATE operations on files below its filter, in response to the IRP_MJ_CREATE operation on a file that the filter driver services on its own file objects. Such a filter driver should propagate any ECP_LIST context structure lists from the original IRP_MJ_CREATE operation on a file to the IRP_MJ_CREATE operations that the filter driver issues below it. By propagating these ECP lists, the filter driver ensures that any filters below the filter that issues the IRP_MJ_CREATE operations are aware of the context of the original IRP_MJ_CREATE operation.
| ECP GUID | ECP コンテキスト構造体と意味 |
|---|---|
| ECP_TYPE_CLFS_CREATE_CONTAINER | The GUID used to identify the CREATE_REDIRECTION_ECP_CONTEXT ECP context structure. この ECP を NTFS に送信すると、ボリューム マウント中に新しい共通ログ ファイル システム (CLFS) コンテナーを挿入できます。 |
| ECP_TYPE_IO_STOP_ON_SYMLINK_FILTER_GUID | The GUID that identifies the IO_STOP_ON_SYMLINK_FILTER_ECP_v0 ECP context structure. この ECP は、指定された再解析タグでのみ動作するように IO_STOP_ON_SYMLINK の動作を制限します。 |
| ECP_TYPE_OPEN_REPARSE_GUID | The GUID that identifies the OPEN_REPARSE_LIST ECP context structure. この ECP は、再解析ポイントのすべてのクラスの再解析動作を抑制することなく、固有の再解析ポイントを開く呼び出し元をサポートします。 |
| GUID_ECP_ATOMIC_CREATE | The GUID that identifies the ATOMIC_CREATE_ECP_CONTEXT ECP context structure. この ECP を使用すると、作成時に特定の補足操作をファイルに対して原子的に実行できます。 |
| GUID_ECP_CLOUDFILES_ATTRIBUTION | クラウド ファイル属性の ECP を識別する GUID。 |
| GUID_ECP_CREATE_REDIRECTION | 特定の作成操作に対してファイルのリダイレクト状態のクエリを実行するために送信可能な ECP を識別するために使用される GUID。 |
| GUID_ECP_CSV_DOWN_LEVEL_OPEN | The GUID that identifies the CSV_DOWN_LEVEL_OPEN_ECP_CONTEXT ECP context structure. クラスター共有ボリューム ファイル システム (CSVFS) は、この ECP をメタデータ ノード (MDS) に送信するもので、作成の種類に関する情報を含みます。 |
| GUID_ECP_CSV_QUERY_FILE_REVISION | The GUID that identifies the CSV_QUERY_FILE_REVISION_ECP_CONTEXT ECP context structure. この ECP を CSVFS に送信すると、ファイルのリビジョン番号を要求できます。 |
| GUID_ECP_CSV_QUERY_FILE_REVISION_FILE_ID_128 | The GUID that identifies the CSV_QUERY_FILE_REVISION_ECP_CONTEXT_FILE_ID_128 ECP context structure. この ECP を CSVFS に送信すると、ファイルのリビジョン番号を要求できます。 |
| GUID_ECP_CSV_SET_HANDLE_PROPERTIES | The GUID that identifies the CSV_SET_HANDLE_PROPERTIES_ECP_CONTEXT ECP context structure. この ECP を CSVFS に送信すると、このオープン時に到着する IO を処理する方法についてプロパティを設定できます。 |
| GUID_ECP_DUAL_OPLOCK_KEY | The GUID that identifies the DUAL OPLOCK_KEY_ECP_CONTEXT ECP context structure. Like the OPLOCK_KEY_ECP_CONTEXT structure, DUAL OPLOCK_KEY_ECP_CONTEXT is used to attach an oplock key to the open file request. With DUAL OPLOCK_KEY_ECP_CONTEXT, a parent key can also be set to provide an oplock for a target file's directory. |
| GUID_ECP_IO_DEVICE_HINT | A GUID that identifies the IO_DEVICE_HINT_ECP_CONTEXT structure. デバイス ヒントは、名前プロバイダーのミニフィルター ドライバーが新しいデバイスの再解析ターゲットを追跡できるよう補助するために使用されます。 |
| GUID_ECP_NETWORK_APP_INSTANCE | The GUID that identifies the NETWORK_APP_INSTANCE_ECP_CONTEXT ECP context structure. フェールオーバー クラスター内のクライアント アプリケーションでは、クラスター内のノードで一連のファイルが開かれている可能性があります。 The file objects are tagged to an application by an instance identifier in the NETWORK_APP_INSTANCE_ECP_CONTEXT structure. フェールオーバー時に、セカンダリ ノードでは、以前キャッシュしたアプリケーション インスタンス識別子を使用して、開いているファイルへのクライアント アプリケーションによるアクセスを検証できます。 |
| GUID_ECP_NETWORK_APP_INSTANCE_VERSION | The GUID that identifies the NETWORK_APP_INSTANCE_VERSION_ECP_CONTEXT structure, which is an ECP context for an application to provide its instance ID. This ECP must accompany a NETWORK_APP_INSTANCE_ECP_CONTEXT (GUID_ECP_NETWORK_APP_INSTANCE) to be valid. |
| GUID_ECP_NETWORK_OPEN_CONTEXT | The GUID that identifies the NETWORK_OPEN_ECP_CONTEXT ECP context structure and is used to attach extra information for network redirectors. This GUID also identifies the NETWORK_OPEN_ECP_CONTEXT_V0 structure for drivers that run on Windows 7 and later versions of Windows and that must interpret network ECP contexts on files that reside on Windows Vista. |
| GUID_ECP_NFS_OPEN | The GUID that identifies the NFS_OPEN_ECP_CONTEXT structure. ネットワーク ファイル システム (NFS) サーバーは、NFS_OPEN_ECP_CONTEXT 構造体をオープン ファイル要求に添付します。 NFS サーバーは、NFS サーバーがクライアント要求を満たすために行うオープン ファイル要求でこの GUID を使用します。 そうすれば、ファイル システム スタックで、NFS_OPEN_ECP_CONTEXT がオープン ファイル要求に添付されているかどうかを判断できます。 NFS_OPEN_ECP_CONTEXT の情報に基づいて、ファイル システム スタックはファイルを開くよう要求したクライアントとその理由を確認できます。 |
| GUID_ECP_OPEN_PARAMETERS | The GUID that identifies the ECP_OPEN_PARAMETERS ECP context structure. 呼び出し元はこの ECP を使用すると、ファイルの既存のハンドルや便宜的ロック (oplock) を妨げることなく、ファイルを開く目的を指定できます。 |
| GUID_ECP_OPLOCK_KEY | The GUID that identifies the OPLOCK_KEY_ECP_CONTEXT ECP context structure and is used to attach an oplock key to the open file request. oplock キーを使用すると、アプリケーションはアプリケーション独自の oplock を中断することなく、同じストリームに対して複数のハンドルを開くことができます。 oplock と oplock キーの詳細については、「Oplock セマンティクスの概要」を参照してください。 |
| GUID_ECP_PREFETCH_OPEN | The GUID that identifies the PREFETCH_OPEN_ECP_CONTEXT ECP context structure. プリフェッチャーは、キャッシュ マネージャーとメモリ マネージャーと緊密に統合された OS コンポーネントで、ディスク アクセスの効率を高めてパフォーマンスを向上させます。 他のコンポーネントがプリフェッチャーに干渉すると、システムのパフォーマンスが低下し、デッドロックが発生する可能性があります。 そこで、プリフェッチャーで PREFETCH_OPEN_ECP_CONTEXT 構造体をファイルに添付し、プリフェッチャーがファイルに対してオープン要求を実行することを通知します。 This open request is specified by the Context member of PREFETCH_OPEN_ECP_CONTEXT. ファイル システム フィルター ドライバーなどのその他のコンポーネントは、PREFETCH_OPEN_ECP_CONTEXT がファイルに添付されているかどうかを判断したうえで、適切なアクションを実行できます。 |
| GUID_ECP_QUERY_ON_CREATE | 作成時のクエリ ファイル情報に対して ECP を識別する GUID。 |
| GUID_ECP_RKF_BYPASS | The GUID that identifies the RKF_BYPASS_ECP_CONTEXT ECP context structure. |
| GUID_ECP_SRV_OPEN | The GUID that identifies the SRV_OPEN_ECP_CONTEXT ECP context structure. サーバーは、SRV_OPEN_ECP_CONTEXT 構造体をオープン ファイル要求に添付します。 サーバーは、サーバーが条件付きのクライアント要求を満たすために行うオープン ファイル要求でこの GUID を使用します。 そうすれば、ファイル システム スタックで、SRV_OPEN_ECP_CONTEXT がオープン ファイル要求に添付されているかどうかを判断できます。 SRV_OPEN_ECP_CONTEXT の情報に基づいて、ファイル システム スタックはファイルを開くよう要求したクライアントとその理由を確認できます。 すべてのサーバーからの作成でこの ECP が実行されるわけではありません。 |
| GUID_ECP_TYPE_VETO_BINDING | Identifies the VETO_BINDING_ECP_CONTEXT ECP context structure. この ECP を使用して、システムのブート パーティション上のバインド リンクを拒否できます。 Windows 11、バージョン 24H2 以降で使用できます。 |