ECP définis par le système
[!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. Le système d’exploitation définit ces ECP dans le fichier d’en-tête Ntifs.h.
Ces ECP définis par le système attachent les informations supplémentaires spécifiées à l’opération IRP_MJ_CREATE sur un fichier. Les éléments de la pile du système de fichiers peuvent interroger les ECP pour les informations supplémentaires.
En règle générale, un filtre qui traite l’opération IRP_MJ_CREATE sur un fichier, puis passe le fichier à des filtres en dessous de lui, ne doit pas attacher et imiter l’un des ECP définis par le système à l’opération IRP_MJ_CREATE sur le fichier.
De même, un pilote en mode noyau qui traite et émet des opérations IRP_MJ_CREATE sur des fichiers ne doit pas attacher et imiter de manière frauduleuse des ECP définis par le système aux opérations IRP_MJ_CREATE sur les fichiers.
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. Il le fait en possédant des objets de fichier et en émettant ses propres opérations IRP_MJ_CREATE sur des fichiers en dessous de son filtre, en réponse à l’opération IRP_MJ_CREATE sur un fichier que le pilote de filtre traite sur ses propres objets de fichier. Un tel pilote de filtre doit propager toutes les listes de structures de contexte ECP_LIST à partir de l’opération IRP_MJ_CREATE d’origine sur un fichier vers les opérations IRP_MJ_CREATE que le pilote de filtre émet en dessous de lui. En propageant ces listes ECP, le pilote de filtre garantit que tous les filtres en dessous du filtre qui émet les opérations IRP_MJ_CREATE sont conscients du contexte de l’opération IRP_MJ_CREATE d’origine.
| GUID ECP | Structure de contexte ECP et signification |
|---|---|
| ECP_TYPE_CLFS_CREATE_CONTAINER | Il s’agit du GUID utilisé pour identifier la structure de contexte ECP CREATE_REDIRECTION_ECP_CONTEXT. 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 | Il s’agit du GUID qui identifie la structure de contexte ECP IO_STOP_ON_SYMLINK_FILTER_ECP_v0. 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 | Il s’agit du GUID qui identifie la structure de contexte ECP OPEN_REPARSE_LIST. 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 | Il s’agit du GUID qui identifie la structure de contexte ECP ATOMIC_CREATE_ECP_CONTEXT. 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 | Il s’agit du GUID qui identifie la structure de contexte ECP CSV_DOWN_LEVEL_OPEN_ECP_CONTEXT. 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 | Il s’adit du GUID qui identifie la structure de contexte ECP CSV_QUERY_FILE_REVISION_ECP_CONTEXT. 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 | Il s’adit du GUID qui identifie la structure de contexte ECP CSV_QUERY_FILE_REVISION_ECP_CONTEXT_FILE_ID_128. Cet ECP peut être envoyé à CSVFS pour demander un numéro de révision de fichier. |
| GUID_ECP_CSV_SET_HANDLE_PROPERTIES | Il s’agit du GUID qui identifie la structure de contexte ECP CSV_SET_HANDLE_PROPERTIES_ECP_CONTEXT. 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 | Il s’agit du GUID qui identifie la structure de contexte DUAL OPLOCK_KEY_ECP_CONTEXT. Comme la structure OPLOCK_KEY_ECP_CONTEXT, DUAL OPLOCK_KEY_ECP_CONTEXT est utilisée pour attacher une clé d’oplock à la demande d’ouverture de fichier. Avec DUAL OPLOCK_KEY_ECP_CONTEXT, une clé parent peut également être définie pour fournir un oplock pour le répertoire du fichier cible. |
| GUID_ECP_IO_DEVICE_HINT | Un GUID qui identifie la structure IO_DEVICE_HINT_ECP_CONTEXT. 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 | Il s’agit du GUID qui identifie la structure de contexte ECP NETWORK_APP_INSTANCE_ECP_CONTEXT. Une application cliente dans un cluster de basculement peut avoir un ensemble de fichiers ouverts sur un nœud du cluster. Les objets de fichier sont étiquetés à une application par un identifiant d’instance dans la structure NETWORK_APP_INSTANCE_ECP_CONTEXT. 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 | Il s’agit du GUID qui identifie la structure NETWORK_APP_INSTANCE_VERSION_ECP_CONTEXT, qui est un contexte ECP pour qu’une application fournisse son identifiant d’instance. Cet ECP doit accompagner un NETWORK_APP_INSTANCE_ECP_CONTEXT (GUID_ECP_NETWORK_APP_INSTANCE) pour être valide. |
| GUID_ECP_NETWORK_OPEN_CONTEXT | Il s’agit du GUID qui identifie la structure de contexte ECP NETWORK_OPEN_ECP_CONTEXT et est utilisé pour attacher des informations supplémentaires pour les redirecteurs réseau. Ce GUID identifie également la structure NETWORK_OPEN_ECP_CONTEXT_V0 pour les pilotes qui s’exécutent sur Windows 7 et les versions ultérieures de Windows et qui doivent interpréter les contextes ECP réseau sur des fichiers qui résident sur Windows Vista. |
| GUID_ECP_NFS_OPEN | Il s’agit du GUID qui identifie la structure de contexte ECP NFS_OPEN_ECP_CONTEXT. 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 | Il s’agit du GUID qui identifie la structure de contexte ECP ECP_OPEN_PARAMETERS. 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 | Il s’agit du GUID qui identifie la structure de contexte ECP OPLOCK_KEY_ECP_CONTEXT et est utilisé pour attacher une clé d’oplock à la demande d’ouverture de fichier. 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 | Il s’agit du GUID qui identifie la structure de contexte ECP PREFETCH_OPEN_ECP_CONTEXT. 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. Cette demande d’ouverture est spécifiée par le membre Contexte de 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 | Il s’agit du GUID qui identifie la structure de contexte ECP RKF_BYPASS_ECP_CONTEXT. |
| GUID_ECP_SRV_OPEN | Il s’agit du GUID qui identifie la structure de contexte ECP SRV_OPEN_ECP_CONTEXT. 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. |
| GUID_ECP_TYPE_VETO_BINDING | Identifie la structure de contexte ECP VETO_BINDING_ECP_CONTEXT. 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. |