Compartir a través de


System-defined ECPs

[!NOTE]

Parte de la información hace referencia a un producto de versión preliminar que puede sufrir importantes modificaciones antes de que se publique la versión comercial. Microsoft no proporciona ninguna garantía, expresa o implícita, con respecto a la información proporcionada aquí.

En esta página se enumeran y describen los parámetros de creación adicionales (ECP) definidos por el 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. Los elementos de la pila del sistema de archivos pueden consultar los ECP para obtener información adicional.

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.

Los controladores de filtro deben considerar que los ECP definidos por el sistema son de solo lectura. Debe usarlos solo para recuperar información.

Una excepción a la restricción de que un controlador de filtro adjunte cualquiera de los siguientes ECP definidos por el sistema es cuando el controlador de filtro implementa un sistema de archivos en capas. 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 Estructura y significado del contexto de ECP
ECP_TYPE_CLFS_CREATE_CONTAINER The GUID used to identify the CREATE_REDIRECTION_ECP_CONTEXT ECP context structure. Este ECP se puede enviar a NTFS para insertar un nuevo contenedor del sistema de archivos de registro común (CLFS) durante el montaje del volumen.
ECP_TYPE_IO_STOP_ON_SYMLINK_FILTER_GUID The GUID that identifies the IO_STOP_ON_SYMLINK_FILTER_ECP_v0 ECP context structure. Este ECP restringe el comportamiento de IO_STOP_ON_SYMLINK a actuar solo en etiquetas de reanálisis especificadas.
ECP_TYPE_OPEN_REPARSE_GUID The GUID that identifies the OPEN_REPARSE_LIST ECP context structure. Este ECP admite que los autores de llamadas abran puntos de reanálisis específicos sin impedir el comportamiento de reanálisis para todas las clases de puntos de reanálisis.
GUID_ECP_ATOMIC_CREATE The GUID that identifies the ATOMIC_CREATE_ECP_CONTEXT ECP context structure. Este ECP permite realizar determinadas operaciones complementarias en un archivo de forma atómica durante la creación.
GUID_ECP_CLOUDFILES_ATTRIBUTION GUID que identifica el ECP para la atribución de archivos en la nube.
GUID_ECP_CREATE_REDIRECTION GUID usado para identificar el ECP que se puede enviar para consultar el estado de redirección de un archivo para una operación de creación específica.
GUID_ECP_CSV_DOWN_LEVEL_OPEN The GUID that identifies the CSV_DOWN_LEVEL_OPEN_ECP_CONTEXT ECP context structure. El sistema de archivos de volúmenes compartidos de clúster (CSVFS) envía este ECP al nodo de metadatos (MDS) y contiene información sobre el tipo de creación.
GUID_ECP_CSV_QUERY_FILE_REVISION The GUID that identifies the CSV_QUERY_FILE_REVISION_ECP_CONTEXT ECP context structure. Este ECP se puede enviar a CSVFS para solicitar un número de revisión de archivo.
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 se puede enviar a CSVFS para solicitar un número de revisión de archivo.
GUID_ECP_CSV_SET_HANDLE_PROPERTIES The GUID that identifies the CSV_SET_HANDLE_PROPERTIES_ECP_CONTEXT ECP context structure. Este ECP se puede enviar a CSVFS para establecer propiedades sobre cómo debe controlar la E/S que llega a esta puerta abierta.
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. Las sugerencias de dispositivo se utilizan para ayudar a los controladores de minifiltro del proveedor de nombres a rastrear un objetivo de reanálisis a un nuevo dispositivo.
GUID_ECP_NETWORK_APP_INSTANCE The GUID that identifies the NETWORK_APP_INSTANCE_ECP_CONTEXT ECP context structure. Una aplicación cliente en un clúster de conmutación por error podría tener un conjunto de archivos abiertos en un nodo del clúster. The file objects are tagged to an application by an instance identifier in the NETWORK_APP_INSTANCE_ECP_CONTEXT structure. En la conmutación por error, un nodo secundario puede validar el acceso de una aplicación cliente a los archivos abiertos con el identificador de instancia de aplicación previamente almacenado en caché.
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. El servidor del sistema de archivos de red (NFS) asocia la estructura NFS_OPEN_ECP_CONTEXT a una solicitud de apertura de archivo. El servidor NFS usa este GUID en cualquier solicitud de apertura de archivo que realice el servidor NFS para satisfacer una solicitud de cliente. A continuación, la pila del sistema de archivos puede determinar si NFS_OPEN_ECP_CONTEXT está asociado a la solicitud de apertura de archivo. Basándose en la información de NFS_OPEN_ECP_CONTEXT, la pila del sistema de archivos puede determinar el cliente que solicitó la apertura del archivo y por qué.
GUID_ECP_OPEN_PARAMETERS The GUID that identifies the ECP_OPEN_PARAMETERS ECP context structure. Este ECP permite al autor de la llamada especificar el propósito de la apertura del archivo sin interferir con los identificadores o bloqueos oportunistas (oplocks) existentes en el archivo.
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 clave de bloqueo oportunista permite a una aplicación abrir varios identificadores en la misma secuencia sin interrumpir el bloqueo oportunista propio de la aplicación. Para obtener más información sobre los bloqueos oportunistas y las claves de bloqueos oportunistas, consulte Información general sobre la semántica de los bloqueos oportunistas.
GUID_ECP_PREFETCH_OPEN The GUID that identifies the PREFETCH_OPEN_ECP_CONTEXT ECP context structure. La captura previa es un componente del sistema operativo que está estrechamente integrado con el administrador de caché y el administrador de memoria para que el acceso al disco sea más eficaz y, por tanto, mejore el rendimiento. Si otros componentes interfieren con la captura previa, el rendimiento del sistema disminuye y se podría producir un bloqueo interno. Por lo tanto, la captura previa adjunta la estructura PREFETCH_OPEN_ECP_CONTEXT a un archivo para comunicar que realiza una solicitud de apertura en el archivo. This open request is specified by the Context member of PREFETCH_OPEN_ECP_CONTEXT. Otros componentes, como los controladores de filtro del sistema de archivos, pueden determinar si PREFETCH_OPEN_ECP_CONTEXT está asociado al archivo y, a continuación, realizar las acciones adecuadas.
GUID_ECP_QUERY_ON_CREATE GUID que identifica el ECP para consultar información del archivo al crear.
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 servidor asocia la estructura SRV_OPEN_ECP_CONTEXT a una solicitud de apertura de . El servidor usa este GUID en cualquier solicitud de apertura de archivo que realice el servidor para satisfacer una solicitud de cliente condicional. A continuación, la pila del sistema de archivos puede determinar si SRV_OPEN_ECP_CONTEXT está asociado a la solicitud de apertura de archivo. Basándose en la información de SRV_OPEN_ECP_CONTEXT, la pila del sistema de archivos puede determinar el cliente que solicitó la apertura del archivo y por qué. No todas las creaciones a partir de servidores llevan este ECP.
GUID_ECP_TYPE_VETO_BINDING Identifies the VETO_BINDING_ECP_CONTEXT ECP context structure. Este ECP se puede usar para vetar un vínculo de enlace en la partición de arranque del sistema. Disponible a partir de Windows 11, versión 24H2.