Partager via

System-defined ECPs

[!NOTE]

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifié avant sa commercialisation. Microsoft n’offre aucune garantie, expresse ou implicite, concernant les informations fournies ici.

Cette page répertorie et décrit les paramètres de création supplémentaires (ECP) définis par le système. 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. Les éléments de la pile du système de fichiers peuvent interroger les ECP pour les informations supplémentaires.

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.

Les pilotes de filtre doivent considérer les ECP définis par le système comme en lecture seule. Vous devez les utiliser uniquement pour récupérer des informations.

Une exception à la restriction d’un pilote de filtre d’attacher l’un des ECP définis par le système est lorsque le pilote de filtre implémente un système de fichiers en couches. 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 Structure de contexte ECP et signification
ECP_TYPE_CLFS_CREATE_CONTAINER The GUID used to identify the CREATE_REDIRECTION_ECP_CONTEXT ECP context structure. Cet ECP peut être envoyé à NTFS pour insérer un nouveau conteneur de système de fichiers de journal commun (CLFS) lors du montage du volume.
ECP_TYPE_IO_STOP_ON_SYMLINK_FILTER_GUID The GUID that identifies the IO_STOP_ON_SYMLINK_FILTER_ECP_v0 ECP context structure. Cet ECP restreint le comportement de IO_STOP_ON_SYMLINK pour agir uniquement sur les balises de réanalyse spécifiées.
ECP_TYPE_OPEN_REPARSE_GUID The GUID that identifies the OPEN_REPARSE_LIST ECP context structure. Cet ECP prend en charge les appelants ouvrant des points de réanalyse spécifiques sans inhiber le comportement de réanalyse pour toutes les classes de points de réanalyse.
GUID_ECP_ATOMIC_CREATE The GUID that identifies the ATOMIC_CREATE_ECP_CONTEXT ECP context structure. Cet ECP permet d’exécuter certaines opérations supplémentaires de manière atomique sur un fichier lors de la création.
GUID_ECP_CLOUDFILES_ATTRIBUTION Il s’agit du GUID qui identifie l’ECP pour l’attribution des fichiers cloud.
GUID_ECP_CREATE_REDIRECTION Il s’agit du GUID utilisé pour identifier l’ECP qui peut être envoyé pour interroger l’état de redirection d’un fichier pour une opération de création spécifique.
GUID_ECP_CSV_DOWN_LEVEL_OPEN The GUID that identifies the CSV_DOWN_LEVEL_OPEN_ECP_CONTEXT ECP context structure. Le système de fichiers des volumes partagés en cluster (CSVFS) envoie cet ECP au nœud de métadonnées (MDS) et contient des informations sur le type de création.
GUID_ECP_CSV_QUERY_FILE_REVISION The GUID that identifies the CSV_QUERY_FILE_REVISION_ECP_CONTEXT ECP context structure. Cet ECP peut être envoyé à CSVFS pour demander un numéro de révision de fichier.
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. Cet ECP peut être envoyé à CSVFS pour demander un numéro de révision de fichier.
GUID_ECP_CSV_SET_HANDLE_PROPERTIES The GUID that identifies the CSV_SET_HANDLE_PROPERTIES_ECP_CONTEXT ECP context structure. Cet ECP peut être envoyé à CSVFS pour définir des propriétés sur la manière dont il doit traiter l’IO arrivant sur cette ouverture.
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. Les indices de périphériques sont utilisés pour aider les mini-filtres fournisseurs de noms à suivre une cible de réanalyse vers un nouveau périphérique.
GUID_ECP_NETWORK_APP_INSTANCE The GUID that identifies the NETWORK_APP_INSTANCE_ECP_CONTEXT ECP context structure. Une application cliente dans un cluster de basculement peut avoir un ensemble de fichiers ouverts sur un nœud du cluster. The file objects are tagged to an application by an instance identifier in the NETWORK_APP_INSTANCE_ECP_CONTEXT structure. En cas de basculement, un nœud secondaire peut valider l’accès d’une application cliente aux fichiers ouverts avec l’identifiant d’instance d’application précédemment mis en cache.
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. Le serveur de système de fichiers réseau (NFS) attache la structure NFS_OPEN_ECP_CONTEXT à une demande d’ouverture de fichier. Le serveur utilise ce GUID sur toute demande d’ouverture de fichier que le serveur effectue pour satisfaire une demande client. La pile de système de fichiers peut ensuite déterminer si NFS_OPEN_ECP_CONTEXT est attaché à la demande d’ouverture de fichier. Sur la base des informations dans NFS_OPEN_ECP_CONTEXT, la pile de système de fichiers peut déterminer le client qui a demandé l’ouverture du fichier et pourquoi.
GUID_ECP_OPEN_PARAMETERS The GUID that identifies the ECP_OPEN_PARAMETERS ECP context structure. Cet ECP permet à un appelant de spécifier le but de l’ouverture de fichier sans interférer avec les descripteurs existants et/ou les verrous opportunistes (oplocks) sur le fichier.
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. La clé d’oplock permet à une application d’ouvrir plusieurs poignées vers le même flux sans rompre l’oplock de l’application elle-même. Pour plus d’informations sur les oplocks et les clés d’oplock, veuillez consulter la section Présentation des sémantiques d’oplock.
GUID_ECP_PREFETCH_OPEN The GUID that identifies the PREFETCH_OPEN_ECP_CONTEXT ECP context structure. Le prefetcher est un composant du système d’exploitation étroitement intégré au gestionnaire de cache et au gestionnaire de mémoire pour rendre les accès au disque plus efficaces et donc améliorer les performances. Si d’autres composants interfèrent avec le prefetcher, les performances du système sont impactées et peuvent entraîner un blocage. Par conséquent, le prefetcher attache la structure PREFETCH_OPEN_ECP_CONTEXT à un fichier pour communiquer que le prefetcher effectue une demande d’ouverture sur le fichier. This open request is specified by the Context member of PREFETCH_OPEN_ECP_CONTEXT. D’autres composants, tels que les pilotes de filtre du système de fichiers, peuvent déterminer si PREFETCH_OPEN_ECP_CONTEXT est attaché au fichier, puis prendre les mesures appropriées.
GUID_ECP_QUERY_ON_CREATE Il s’agit du GUID qui identifie l’ECP pour interroger les informations de fichier lors de la création.
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. Un serveur attache la structure SRV_OPEN_ECP_CONTEXT à une demande d’ouverture de fichier. Le serveur utilise ce GUID sur toute demande d’ouverture de fichier que le serveur effectue pour satisfaire une demande client conditionnelle. La pile de système de fichiers peut ensuite déterminer si SRV_OPEN_ECP_CONTEXT est attaché à la demande d’ouverture de fichier. La pile de système de fichiers peut ensuite déterminer si SRV_OPEN_ECP_CONTEXT est attaché à la demande d’ouverture de fichier. Toutes les créations à partir de serveurs n’ont pas cette clé ECP.
GUID_ECP_TYPE_VETO_BINDING Identifies the VETO_BINDING_ECP_CONTEXT ECP context structure. Cet ECP peut être utilisé pour mettre un veto sur un Bind Link sur la partition de démarrage du système. Disponible à partir de Windows 11, version 24H2.
  • Last updated on