Freigeben über


System-defined ECPs

[!NOTE]

Einige Informationen beziehen sich auf Vorabversionen, die vor der kommerziellen Freigabe grundlegend geändert werden können. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Auf dieser Seite werden vom System definierte zusätzliche Erstellungsparameter (ECPs) aufgelistet und beschrieben. 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. Elemente des Dateisystemstapels können die ECPs nach zusätzlichen Informationen abfragen.

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.

Filtertreiber sollten systemdefinierte ECPs als schreibgeschützt betrachten. Sie sollten diese nur zum Abrufen von Informationen verwenden.

Eine Ausnahme beim Einschränken der Anfügung eines der folgenden systemdefinierten ECPs durch einen Filtertreiber besteht darin, dass der Filtertreiber ein mehrschichtiges Dateisystem implementiert. 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-Kontextstruktur und Bedeutung
ECP_TYPE_CLFS_CREATE_CONTAINER The GUID used to identify the CREATE_REDIRECTION_ECP_CONTEXT ECP context structure. Dieser ECP kann an NTFS gesendet werden, um während der Volume-Bereitstellung einen neuen gemeinsamen CLFS-Container (Common Log File System) einzufügen.
ECP_TYPE_IO_STOP_ON_SYMLINK_FILTER_GUID The GUID that identifies the IO_STOP_ON_SYMLINK_FILTER_ECP_v0 ECP context structure. Dieser ECP schränkt das Verhalten von IO_STOP_ON_SYMLINK auf bestimmte Analysetags ein.
ECP_TYPE_OPEN_REPARSE_GUID The GUID that identifies the OPEN_REPARSE_LIST ECP context structure. Dieses ECP unterstützt Aufrufer, die bestimmte Analysepunkte öffnen, ohne das Analyseverhalten für alle Klassen von Analysepunkten zu verhindern.
GUID_ECP_ATOMIC_CREATE The GUID that identifies the ATOMIC_CREATE_ECP_CONTEXT ECP context structure. Dieses ECP ermöglicht die atomare Ausführung bestimmter zusätzlicher Vorgänge an einer Datei während der Erstellung.
GUID_ECP_CLOUDFILES_ATTRIBUTION Die GUID, die die ECP für die Zuordnung von Clouddateien identifiziert.
GUID_ECP_CREATE_REDIRECTION Die GUID, die verwendet wird, um den ECP zu identifizieren, der an den Umleitungsstatus einer Datei für einen bestimmten Erstellungsvorgang gesendet werden kann.
GUID_ECP_CSV_DOWN_LEVEL_OPEN The GUID that identifies the CSV_DOWN_LEVEL_OPEN_ECP_CONTEXT ECP context structure. Das Dateisystem für freigegebene Clustervolumes (Cluster Shared Volumes File System, CSVFS) sendet dieses ECP an den Metadatenknoten (Metadata Node, MDS) und enthält Informationen zum Typ der Erstellung.
GUID_ECP_CSV_QUERY_FILE_REVISION The GUID that identifies the CSV_QUERY_FILE_REVISION_ECP_CONTEXT ECP context structure. Dieses ECP kann an CSVFS gesendet werden, um eine Dateirevisionsnummer anzufordern.
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. Dieses ECP kann an CSVFS gesendet werden, um eine Dateirevisionsnummer anzufordern.
GUID_ECP_CSV_SET_HANDLE_PROPERTIES The GUID that identifies the CSV_SET_HANDLE_PROPERTIES_ECP_CONTEXT ECP context structure. Dieses ECP kann an CSVFS gesendet werden, um Eigenschaften festzulegen, wie es mit bei dieser Öffnung eingehenden E/A umgehen soll.
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. Gerätehinweise werden verwendet, um Namensanbieter-Minifiltertreiber bei der Nachverfolgung eines Analyseziels auf neues Gerät zu unterstützen.
GUID_ECP_NETWORK_APP_INSTANCE The GUID that identifies the NETWORK_APP_INSTANCE_ECP_CONTEXT ECP context structure. Eine Clientanwendung in einem Failovercluster verfügt möglicherweise über eine Reihe von Dateien, die auf einem Knoten im Cluster geöffnet sind. The file objects are tagged to an application by an instance identifier in the NETWORK_APP_INSTANCE_ECP_CONTEXT structure. Bei einem Failover kann ein sekundärer Knoten den Zugriff einer Clientanwendung auf die geöffneten Dateien anhand der zuvor zwischengespeicherten Anwendungsinstanzkennung validieren.
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. Der NFS-Server (Network File System) fügt die NFS_OPEN_ECP_CONTEXT Struktur an eine offene Dateianforderung an. Der NFS-Server verwendet diese GUID für jede offene Dateianforderung, die der NFS-Server zur Erfüllung einer Clientanforderung vorgibt. Der Dateisystemstapel kann dann bestimmen, ob NFS_OPEN_ECP_CONTEXT an die Anforderung zum Öffnen einer Datei angehängt ist. Basierend auf den Informationen in NFS_OPEN_ECP_CONTEXT kann der Dateisystemstapel den Client ermitteln, der die Datei geöffnet und warum angefordert hat.
GUID_ECP_OPEN_PARAMETERS The GUID that identifies the ECP_OPEN_PARAMETERS ECP context structure. Mit diesem ECP kann ein Aufrufer den Zweck der geöffneten Datei angeben, ohne vorhandene Handles und/oder opportunistische Sperren (Oplocks) für die Datei zu beeinträchtigen.
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. Mit der Oplock-Taste kann eine Anwendung mehrere Handles für denselben Datenstrom öffnen, ohne das eigene Oplock der Anwendung zu unterbrechen. Weitere Informationen zu Oplocks und Oplock-Tasten finden Sie unter Übersicht über die Oplock-Semantik.
GUID_ECP_PREFETCH_OPEN The GUID that identifies the PREFETCH_OPEN_ECP_CONTEXT ECP context structure. Der Prefetcher ist eine Betriebssystemkomponente, die eng mit dem Cache-Manager und dem Speichermanager integriert ist, um Festplattenzugriffe effizienter zu gestalten und somit die Leistung zu verbessern. Wenn andere Komponenten den Prefetcher beeinträchtigen, verringert sich die Systemleistung und kann deadlocken. Daher fügt der Prefetcher die PREFETCH_OPEN_ECP_CONTEXT Struktur an eine Datei an, um zu kommunizieren, dass der Prefetcher eine offene Anforderung für die Datei ausführt. This open request is specified by the Context member of PREFETCH_OPEN_ECP_CONTEXT. Andere Komponenten, z. B. Dateisystemfiltertreiber, können bestimmen, ob PREFETCH_OPEN_ECP_CONTEXT an die Datei angefügt ist, und dann geeignete Maßnahmen ergreifen.
GUID_ECP_QUERY_ON_CREATE Die GUID, die den ECP für Abfragedateiinformationen beim Erstellen identifiziert.
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. Ein Server fügt die SRV_OPEN_ECP_CONTEXT Struktur an eine offene Dateianforderung an. Der Server verwendet diese GUID für jede offene Dateianforderung, die der Server stellt, um eine bedingte Clientanforderung zu erfüllen. Der Dateisystemstapel kann dann bestimmen, ob SRV_OPEN_ECP_CONTEXT an die Anforderung zum Öffnen einer Datei angehängt ist. Anhand der Informationen in SRV_OPEN_ECP_CONTEXT kann der Dateisystemstapel den Client ermitteln, der das Öffnen der Datei angefordert hat, und den Grund dafür angeben. Nicht alle Erstellen von Servern tragen diesen ECP.
GUID_ECP_TYPE_VETO_BINDING Identifies the VETO_BINDING_ECP_CONTEXT ECP context structure. Dieser ECP kann verwendet werden, um einen Bind-Link auf der Boot-Partition des Systems zu blockieren. Verfügbar ab Windows 11, Version 24H2.