[!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 的其中一個例外狀況，就是篩選驅動程式實作分層文件系統時。 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 可讓呼叫端指定檔案開啟的目的，而不會干擾檔案上現有的句柄和/或機會鎖定（oplocks）。 |
| 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。 如需 oplocks 和 oplock 索引鍵的詳細資訊，請參閱 Oplock Semantics Overview。 |
| 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 開始提供。 |