estructura de MARK_HANDLE_INFO (ntifs.h)

Se pasa una estructura MARK_HANDLE_INFO como búfer de entrada durante una solicitud de código de control de FSCTL_MARK_HANDLE .

Sintaxis

typedef struct _MARK_HANDLE_INFO {
  union {
    ULONG UsnSourceInfo;
    ULONG CopyNumber;
  } DUMMYUNIONNAME;
  ULONG  UsnSourceInfo;
  HANDLE VolumeHandle;
  ULONG  HandleInfo;
} MARK_HANDLE_INFO, *PMARK_HANDLE_INFO;

Miembros

DUMMYUNIONNAME

DUMMYUNIONNAME.UsnSourceInfo

Consulte UsnSourceInfo a continuación.

DUMMYUNIONNAME.CopyNumber

Identifica la copia de un archivo que se va a leer al leer desde un archivo que reside en medios redundantes.

UsnSourceInfo

Marcas de información de origen opcionales del número de secuencia de actualización (USN). Para establecer cualquiera de estos valores, se debe especificar un identificador DASD de volumen en el campo VolumeHandle . Puede ser una combinación de los valores siguientes:

Marca	Significado
USN_SOURCE_DATA_MANAGEMENT	El servicio no modifica la vista externa de ninguna parte del archivo. El caso típico es el movimiento de datos de HSM hacia y desde el almacenamiento externo.
USN_SOURCE_AUXILIARY_DATA	El servicio no modifica la vista externa del archivo con respecto a la aplicación que creó este archivo. Se puede usar para agregar flujos de datos privados a un archivo.
USN_SOURCE_REPLICATION_MANAGEMENT	El servicio está modificando un archivo para que coincida con el contenido del mismo archivo que existe en otro miembro del conjunto de réplicas.
USN_SOURCE_CLIENT_REPLICATION_MANAGEMENT	La replicación se realiza en sistemas cliente desde la nube o los servidores. No es necesario un identificador de volumen para establecer este valor.

VolumeHandle

Identificador de volumen para esta operación.

HandleInfo

Contiene marcas para identificar la solicitud. Este campo puede ser uno de los siguientes valores:

Marca	Significado
MARK_HANDLE_PROTECT_CLUSTERS	No permita ninguna desfragmentación (FSCTL_MOVE_FILE) hasta que se cierre el identificador.
MARK_HANDLE_TXF_SYSTEM_LOG	Esta secuencia se usa como registro de Txf para un administrador de recursos en el volumen. Debe llamarse en el kernel mediante IRP_MN_KERNEL_CALL. Disponible a partir de Windows Vista.
MARK_HANDLE_NOT_TXF_SYSTEM_LOG	Este componente ya no usa este objeto como un archivo de registro TxF. Disponible a partir de Windows Vista.
MARK_HANDLE_REALTIME	Solo es compatible con el sistema de archivos UDFS. Marca el dispositivo para hacer streaming en tiempo real del vídeo. Disponible a partir de Windows 7.
MARK_HANDLE_NOT_REALTIME	Solo es compatible con el sistema de archivos UDFS. Marca el dispositivo para que ya no realice streaming en tiempo real del vídeo. Disponible a partir de Windows 7.
MARK_HANDLE_CLOUD_SYNC	Obsoleto; no use esta marca.
MARK_HANDLE_READ_COPY	Los datos se deben leer de la copia de datos especificada. Solo se admite para volúmenes redundantes de Espacios de almacenamiento. Disponible a partir de Windows 8.
MARK_HANDLE_NOT_READ_COPY	Los datos ya no se van a leer desde una copia específica. Solo se admite para volúmenes redundantes de Espacios de almacenamiento. Disponible a partir de Windows 8.
MARK_HANDLE_FILTER_METADATA	Reservado solo para uso interno de Microsoft.
MARK_HANDLE_RETURN_PURGE_FAILURE	Al mezclar la E/S asignada o almacenada en caché con E/S no almacenada en caché y se emite una E/S no almacenada en caché, el sistema intenta purgar las asignaciones de memoria para el intervalo de la E/S no almacenada en caché. Si se produce un error en estas purgas, el sistema normalmente no devuelve el error al autor de la llamada, lo que puede provocar un estado dañado. Esta marca indica al sistema que devuelva errores de purga para el identificador especificado para que la aplicación pueda controlar mejor esta situación. Disponible a partir de Windows 8.1.
MARK_HANDLE_DISABLE_FILE_METADATA_OPTIMIZATION	Deshabilita la característica de compactación del Servicio de replicación de archivos (FRS) en el archivo especificado. Disponible a partir de Windows 10 versión 1507.
MARK_HANDLE_ENABLE_USN_SOURCE_ON_PAGING_IO	Indica a NTFS que establezca el valor UsnSourceInfo especificado en escrituras de paginación en el Journal USN. Tradicionalmente, esto no se hacía en las escrituras de paginación, ya que no sabía qué subproceso realizó los cambios especificados. Se trata de una invalidación. Esto solo funciona si el objeto FileObject en el que se encuentra el Administrador de memoria tiene este estado asociado. Disponible a partir de Windows 10 versión 1507.
MARK_HANDLE_SKIP_COHERENCY_SYNC_DISALLOW_WRITES	Indica al sistema que no se permiten escrituras en este archivo. Si alguien intenta abrir el archivo para el acceso de escritura, se produce un error en la operación con STATUS_ACCESS_DENIED. Si se ve un error en una escritura, la operación no se pudo realizar con STATUS_MARKED_TO_DISALLOW_WRITES. Disponible a partir de Windows 10 versión 1507.
MARK_HANDLE_ENABLE_CPU_CACHE	Reservado solo para uso interno de Microsoft.
MARK_HANDLE_SUPPRESS_VOLUME_OPEN_FLUSH	Normalmente, en la primera operación de lectura y escritura en un identificador de volumen (abierto DASD), el sistema de archivos vacía el volumen. Esto puede tener consecuencias de rendimiento en determinados escenarios. Si esta marca está establecida en un identificador de volumen, suprimirá ese vaciado en la primera E/S. Disponible a partir de Windows 11.

Comentarios

MARK_HANDLE_INFO contiene la información utilizada para marcar un archivo o directorio especificados y su registro de diario de cambios de número de secuencia de actualización (USN) con datos sobre los cambios.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP
Encabezado	ntifs.h

Consulte también

FSCTL_MARK_HANDLE