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 |