Compartilhar via


System-defined ECPs

[!NOTE]

Algumas informações referem-se a um produto de pré-lançamento que pode ser substancialmente modificado antes de ser lançado comercialmente. A Microsoft não oferece nenhuma garantia, explícita ou implícita, quanto às informações fornecidas aqui.

Esta página lista e descreve os parâmetros de criação extra (ECPs) definidos pelo sistema. 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. Os elementos da pilha do sistema de arquivos podem consultar os ECPs para obter informações extras.

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.

Os drivers de filtro devem considerar os ECPs definidos pelo sistema como somente leitura. Você deve usá-los apenas para recuperar informações.

Uma exceção à restrição de um driver de filtro de anexar qualquer um dos seguintes ECPs definidos pelo sistema é quando o driver de filtro implementa um sistema de arquivos em camadas. 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 Estrutura e significado do contexto ECP
ECP_TYPE_CLFS_CREATE_CONTAINER The GUID used to identify the CREATE_REDIRECTION_ECP_CONTEXT ECP context structure. Esse ECP pode ser enviado ao NTFS para inserir um novo contêiner de sistema de arquivos de log comum (CLFS) durante a montagem do volume.
ECP_TYPE_IO_STOP_ON_SYMLINK_FILTER_GUID The GUID that identifies the IO_STOP_ON_SYMLINK_FILTER_ECP_v0 ECP context structure. Esse ECP restringe o comportamento de IO_STOP_ON_SYMLINK para agir somente em marcas de nova análise especificadas.
ECP_TYPE_OPEN_REPARSE_GUID The GUID that identifies the OPEN_REPARSE_LIST ECP context structure. Esse ECP tem suporte para chamadores que abrem pontos de nova análise específicos sem inibir o comportamento de nova análise para todas as classes de pontos de nova análise.
GUID_ECP_ATOMIC_CREATE The GUID that identifies the ATOMIC_CREATE_ECP_CONTEXT ECP context structure. Esse ECP permite que determinadas operações suplementares sejam executadas em um arquivo atomicamente durante a criação.
GUID_ECP_CLOUDFILES_ATTRIBUTION O GUID que identifica o ECP para atribuição de arquivos em nuvem.
GUID_ECP_CREATE_REDIRECTION O GUID usado para identificar o ECP que pode ser enviado para consultar o estado de redirecionamento de um arquivo para uma operação de criação específica.
GUID_ECP_CSV_DOWN_LEVEL_OPEN The GUID that identifies the CSV_DOWN_LEVEL_OPEN_ECP_CONTEXT ECP context structure. O sistema de arquivos de Volumes Compartilhados Clusterizados (CSVFS) envia esse ECP para o Nó de Metadados (MDS) e contém informações sobre o tipo de criação.
GUID_ECP_CSV_QUERY_FILE_REVISION The GUID that identifies the CSV_QUERY_FILE_REVISION_ECP_CONTEXT ECP context structure. Este ECP pode ser enviado ao CSVFS para solicitar um número de revisão de arquivo.
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. Este ECP pode ser enviado ao CSVFS para solicitar um número de revisão de arquivo.
GUID_ECP_CSV_SET_HANDLE_PROPERTIES The GUID that identifies the CSV_SET_HANDLE_PROPERTIES_ECP_CONTEXT ECP context structure. Esse ECP pode ser enviado ao CSVFS para definir propriedades sobre como ele deve lidar com a E/S que chega nessa abertura.
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. As dicas de dispositivo são usadas para ajudar os drivers de minifiltro do provedor de nomes a rastrear um destino de nova análise para um novo dispositivo.
GUID_ECP_NETWORK_APP_INSTANCE The GUID that identifies the NETWORK_APP_INSTANCE_ECP_CONTEXT ECP context structure. Um aplicativo cliente em um cluster de failover pode ter um conjunto de arquivos abertos em um nó no cluster. The file objects are tagged to an application by an instance identifier in the NETWORK_APP_INSTANCE_ECP_CONTEXT structure. No failover, um nó secundário pode validar o acesso de um aplicativo cliente aos arquivos abertos com o identificador de instância do aplicativo armazenado em cache anteriormente.
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. O servidor NFS (Network File System) anexa a estrutura NFS_OPEN_ECP_CONTEXT a uma solicitação de arquivo aberto. O servidor NFS usa esse GUID em qualquer solicitação de arquivo aberto que o servidor NFS faz para satisfazer uma solicitação do cliente. A pilha do sistema de arquivos pode determinar se NFS_OPEN_ECP_CONTEXT está anexado à solicitação de arquivo aberto. Com base nas informações de NFS_OPEN_ECP_CONTEXT, a pilha do sistema de arquivos pode determinar o cliente que solicitou que o arquivo fosse aberto e por quê.
GUID_ECP_OPEN_PARAMETERS The GUID that identifies the ECP_OPEN_PARAMETERS ECP context structure. Esse ECP permite que um chamador especifique a finalidade da abertura do arquivo sem interferir com identificadores existentes e/ou bloqueios oportunistas (oplocks) no arquivo.
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. A chave oplock permite que um aplicativo abra vários identificadores para o mesmo fluxo sem quebrar a própria oplock do aplicativo. Para obter mais informações sobre oplocks e chaves oplock, consulte Visão geral da semântica de oplock.
GUID_ECP_PREFETCH_OPEN The GUID that identifies the PREFETCH_OPEN_ECP_CONTEXT ECP context structure. O prefetcher é um componente do sistema operacional que está totalmente integrado com o gerenciador de cache e o gerenciador de memória para tornar os acessos ao disco mais eficientes e, portanto, melhorar o desempenho. Se outros componentes interferirem no prefetcher, o desempenho do sistema diminuirá e poderá causar deadlock. Portanto, o prefetcher anexa a estrutura PREFETCH_OPEN_ECP_CONTEXT a um arquivo para comunicar que o prefetcher executa uma solicitação aberta no arquivo. This open request is specified by the Context member of PREFETCH_OPEN_ECP_CONTEXT. Outros componentes, como drivers de filtro do sistema de arquivos, podem determinar se PREFETCH_OPEN_ECP_CONTEXT está anexado ao arquivo e, em seguida, tomar as medidas apropriadas.
GUID_ECP_QUERY_ON_CREATE O GUID que identifica o ECP para informações de arquivo de consulta na criação.
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. Um servidor anexa a estrutura SRV_OPEN_ECP_CONTEXT a uma solicitação de arquivo aberto. O servidor usa esse GUID em qualquer solicitação de arquivo aberto que o servidor faz para satisfazer uma solicitação de cliente condicional. A pilha do sistema de arquivos pode determinar se SRV_OPEN_ECP_CONTEXT está anexado à solicitação de arquivo aberto. Com base nas informações de SRV_OPEN_ECP_CONTEXT, a pilha do sistema de arquivos pode determinar o cliente que solicitou que o arquivo fosse aberto e por quê. Nem todas as criações de servidores carregam esse ECP.
GUID_ECP_TYPE_VETO_BINDING Identifies the VETO_BINDING_ECP_CONTEXT ECP context structure. Esse ECP pode ser usado para vetar um link de associação na partição de inicialização do sistema. Disponível a partir do Windows 11, versão 24H2.