ECPs definidos pelo sistema

[!OBSERVAÇÃO]

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. O sistema operacional define esses ECPs no arquivo de cabeçalho Ntifs.h.

Esses ECPs definidos pelo sistema anexam as informações extras especificadas à operação IRP_MJ_CREATE em um arquivo. Os elementos da pilha do sistema de arquivos podem consultar os ECPs para obter informações extras.

Geralmente, um filtro que processa a operação IRP_MJ_CREATE em um arquivo e, em seguida, passa o arquivo para os filtros abaixo dele não deve anexar e falsificar qualquer um dos ECPs definidos pelo sistema para a operação IRP_MJ_CREATE no arquivo.

Da mesma forma, um driver de modo kernel que processa e emite operações IRP_MJ_CREATE em arquivos não deve anexar e falsificar nenhum ECP definido pelo sistema às operações IRP_MJ_CREATE nos arquivos.

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. Ele faz isso possuindo objetos de arquivo e emitindo suas próprias operações IRP_MJ_CREATE em arquivos abaixo de seu filtro, em resposta à operação IRP_MJ_CREATE em um arquivo que o driver de filtro atende em seus próprios objetos de arquivo. Esse driver de filtro deve propagar todas as listas de estrutura de contexto ECP_LIST da operação IRP_MJ_CREATE em um arquivo para as operações IRP_MJ_CREATE que o driver de filtro emite abaixo dela. Ao propagar essas listas de ECP, o driver de filtro garante que todos os filtros abaixo do filtro que emite as operações IRP_MJ_CREATE estejam cientes do contexto da operação IRP_MJ_CREATE original.

ECP GUID	Estrutura e significado do contexto ECP
ECP_TYPE_CLFS_CREATE_CONTAINER	O GUID usado para identificar a estrutura de contexto ECP CREATE_REDIRECTION_ECP_CONTEXT. 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	O GUID que identifica a estrutura de contexto ECP IO_STOP_ON_SYMLINK_FILTER_ECP_v0. 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	O GUID que identifica a estrutura de contexto ECP OPEN_REPARSE_LIST. 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	O GUID que identifica a estrutura de contexto ECP ATOMIC_CREATE_ECP_CONTEXT. 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	O GUID que identifica a estrutura de contexto ECP CSV_DOWN_LEVEL_OPEN_ECP_CONTEXT. 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	O GUID que identifica a estrutura de contexto ECP CSV_QUERY_FILE_REVISION_ECP_CONTEXT. 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	O GUID que identifica a estrutura de contexto ECP CSV_QUERY_FILE_REVISION_ECP_CONTEXT_FILE_ID_128. Este ECP pode ser enviado ao CSVFS para solicitar um número de revisão de arquivo.
GUID_ECP_CSV_SET_HANDLE_PROPERTIES	O GUID que identifica a estrutura de contexto ECP CSV_SET_HANDLE_PROPERTIES_ECP_CONTEXT. 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	O GUID que identifica a estrutura de contexto ECP DUAL OPLOCK_KEY_ECP_CONTEXT. Assim como a estrutura OPLOCK_KEY_ECP_CONTEXT, DUAL OPLOCK_KEY_ECP_CONTEXT é usada para anexar uma chave oplock à solicitação de arquivo aberto. Com DUAL OPLOCK_KEY_ECP_CONTEXT, uma chave pai também pode ser definida para fornecer uma chave oplock para o diretório de um arquivo de destino.
GUID_ECP_IO_DEVICE_HINT	Um GUID que identifica a estrutura IO_DEVICE_HINT_ECP_CONTEXT. 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	O GUID que identifica a estrutura de contexto ECP NETWORK_APP_INSTANCE_ECP_CONTEXT. Um aplicativo cliente em um cluster de failover pode ter um conjunto de arquivos abertos em um nó no cluster. Os objetos de arquivo são marcados em um aplicativo por um identificador de instância na estrutura NETWORK_APP_INSTANCE_ECP_CONTEXT. 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	O GUID que identifica a estrutura NETWORK_APP_INSTANCE_VERSION_ECP_CONTEXT, que é um contexto ECP para um aplicativo fornecer sua ID de instância. Esse ECP deve acompanhar uma NETWORK_APP_INSTANCE_ECP_CONTEXT (GUID_ECP_NETWORK_APP_INSTANCE) para ser válido.
GUID_ECP_NETWORK_OPEN_CONTEXT	O GUID que identifica a estrutura de contexto ECP NETWORK_OPEN_ECP_CONTEXT e é usado para anexar informações extras para redirecionadores de rede. Esse GUID também identifica a estrutura NETWORK_OPEN_ECP_CONTEXT_V0 para drivers executados no Windows 7 e em versões posteriores e que devem interpretar contextos ECP de rede em arquivos que residem no Windows Vista.
GUID_ECP_NFS_OPEN	O GUID que identifica a estrutura NFS_OPEN_ECP_CONTEXT. 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	O GUID que identifica a estrutura de contexto ECP ECP_OPEN_PARAMETERS. 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	O GUID que identifica a estrutura de contexto ECP OPLOCK_KEY_ECP_CONTEXT e é usado para anexar uma chave oplock à solicitação de arquivo aberto. 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	O GUID que identifica a estrutura de contexto ECP PREFETCH_OPEN_ECP_CONTEXT. 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. Essa solicitação aberta é especificada pelo membro Context de 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	O GUID que identifica a estrutura de contexto ECP RKF_BYPASS_ECP_CONTEXT.
GUID_ECP_SRV_OPEN	O GUID que identifica a estrutura de contexto SRV_OPEN_ECP_CONTEXT. 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ê.
GUID_ECP_TYPE_VETO_BINDING	Identifica a estrutura de contexto ECP VETO_BINDING_ECP_CONTEXT. 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.