ECP definidos por el sistema

  • Artículo

[!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. El sistema operativo define estos ECP en el archivo de encabezado Ntifs.h.

Estos ECP definidos por el sistema aportan la información adicional especificada a la operación de IRP_MJ_CREATE en un archivo. Los elementos de la pila del sistema de archivos pueden consultar los ECP para obtener información adicional.

Normalmente, un filtro que procesa la operación de IRP_MJ_CREATE en un archivo y, a continuación, transfiere el archivo a filtros inferiores no debe adjuntar ni suplantar ninguna de los ECP definidos por el sistema a la operación de IRP_MJ_CREATE en el archivo.

Del mismo modo, un controlador en modo kernel que procesa y emite operaciones de IRP_MJ_CREATE en archivos no debe adjuntar ni suplantar los ECP definidos por el sistema a las operaciones de IRP_MJ_CREATE en los archivos.

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. Lo hace tomando posesión de objetos de archivo y emitiendo sus propias operaciones de IRP_MJ_CREATE en archivos por debajo de su filtro, en respuesta a la operación de IRP_MJ_CREATE en un archivo que el controlador de filtro atiende en sus propios objetos de archivo. Este tipo de controlador de filtro debe propagar las listas de estructura de contexto de ECP_LIST de la operación de IRP_MJ_CREATE original en un archivo a las operaciones de IRP_MJ_CREATE que emite el controlador de filtro debajo de él. Al propagar estas listas de ECP, el controlador de filtro garantiza que todos los filtros debajo del filtro que emite las operaciones de IRP_MJ_CREATE sean conscientes del contexto de la operación de IRP_MJ_CREATE original.

GUID de ECP Estructura y significado del contexto de ECP
ECP_TYPE_CLFS_CREATE_CONTAINER GUID usado para identificar la estructura de contexto de ECP de CREATE_REDIRECTION_ECP_CONTEXT. 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 GUID que identifica la estructura de contexto de ECP de IO_STOP_ON_SYMLINK_FILTER_ECP_v0. Este ECP restringe el comportamiento de IO_STOP_ON_SYMLINK a actuar solo en etiquetas de reanálisis especificadas.
ECP_TYPE_OPEN_REPARSE_GUID GUID que identifica la estructura de contexto de ECP de OPEN_REPARSE_LIST. 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 GUID que identifica la estructura de contexto de ECP de ATOMIC_CREATE_ECP_CONTEXT. 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 GUID que identifica la estructura de contexto de ECP de CSV_DOWN_LEVEL_OPEN_ECP_CONTEXT. 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 GUID que identifica la estructura de contexto de ECP de CSV_QUERY_FILE_REVISION_ECP_CONTEXT. 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 GUID que identifica la estructura de contexto de ECP de CSV_QUERY_FILE_REVISION_ECP_CONTEXT_FILE_ID_128. Este ECP se puede enviar a CSVFS para solicitar un número de revisión de archivo.
GUID_ECP_CSV_SET_HANDLE_PROPERTIES GUID que identifica la estructura de contexto de ECP de CSV_SET_HANDLE_PROPERTIES_ECP_CONTEXT . 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 GUID que identifica la estructura de contexto de ECP de DUAL OPLOCK_KEY_ECP_CONTEXT. Al igual que la estructura de OPLOCK_KEY_ECP_CONTEXT, se usa DUAL OPLOCK_KEY_ECP_CONTEXT para adjuntar una clave de bloqueo oportunista a la solicitud de apertura de archivo. Con DUAL OPLOCK_KEY_ECP_CONTEXT, también se puede establecer una clave primaria para proporcionar un bloqueo oportunista para el directorio de un archivo de destino.
GUID_ECP_IO_DEVICE_HINT GUID que identifica la estructura de IO_DEVICE_HINT_ECP_CONTEXT. 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 GUID que identifica la estructura de contexto de ECP de NETWORK_APP_INSTANCE_ECP_CONTEXT. 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. Los objetos de archivo se etiquetan en una aplicación mediante un identificador de instancia en la estructura NETWORK_APP_INSTANCE_ECP_CONTEXT. 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 GUID que identifica la estructura de NETWORK_APP_INSTANCE_VERSION_ECP_CONTEXT, que es un contexto de ECP para que una aplicación proporcione su identificador de instancia. Este ECP debe acompañar a un NETWORK_APP_INSTANCE_ECP_CONTEXT (GUID_ECP_NETWORK_APP_INSTANCE) para que sea válido.
GUID_ECP_NETWORK_OPEN_CONTEXT GUID que identifica la estructura de contexto de ECP de NETWORK_OPEN_ECP_CONTEXT y se usa para adjuntar información adicional para los redirectores de red. Este GUID también identifica la estructura de NETWORK_OPEN_ECP_CONTEXT_V0 para los controladores que se ejecutan en Windows 7 y versiones posteriores de Windows y que deben interpretar los contextos de ECP de red en archivos que residen en Windows Vista.
GUID_ECP_NFS_OPEN GUID que identifica la estructura NFS_OPEN_ECP_CONTEXT. 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 GUID que identifica la estructura de contexto de ECP de ECP_OPEN_PARAMETERS. 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 GUID que identifica la estructura de contexto de ECP de OPLOCK_KEY_ECP_CONTEXT y se usa para adjuntar una clave de bloqueo oportunista a la solicitud de apertura de archivo. 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 GUID que identifica la estructura de contexto de ECP de PREFETCH_OPEN_ECP_CONTEXT. 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. Esta solicitud de apertura se especifica mediante el miembro Context de 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 GUID que identifica la estructura de contexto de ECP de RKF_BYPASS_ECP_CONTEXT.
GUID_ECP_SRV_OPEN GUID que identifica la estructura de contexto de ECP de SRV_OPEN_ECP_CONTEXT. 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 Identifica la estructura de contexto de ECP de VETO_BINDING_ECP_CONTEXT. 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.