structure MARK_HANDLE_INFO (ntifs.h)

  • Article

Une structure MARK_HANDLE_INFO est passée en tant que mémoire tampon d’entrée lors d’une demande de code de contrôle FSCTL_MARK_HANDLE .

Syntaxe

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

Membres

DUMMYUNIONNAME

DUMMYUNIONNAME.UsnSourceInfo

Consultez UsnSourceInfo ci-dessous.

DUMMYUNIONNAME.CopyNumber

Identifie la copie d’un fichier à lire lors de la lecture à partir d’un fichier qui réside sur un média redondant.

UsnSourceInfo

Indicateurs d’informations sources de numéro de séquence de mise à jour (USN) facultatifs. Pour définir l’une de ces valeurs, un handle DASD de volume doit être spécifié dans le champ VolumeHandle . Il peut s’agir d’une combinaison des valeurs suivantes :

Indicateur Signification
USN_SOURCE_DATA_MANAGEMENT Le service ne modifie pas l’affichage externe d’une partie du fichier. Le cas classique est le déplacement de données HSM vers et à partir d’un stockage externe.
USN_SOURCE_AUXILIARY_DATA Le service ne modifie pas la vue externe du fichier en ce qui concerne l’application qui a créé ce fichier. Peut être utilisé pour ajouter des flux de données privés à un fichier.
USN_SOURCE_REPLICATION_MANAGEMENT Le service modifie un fichier pour qu’il corresponde au contenu du même fichier qui existe dans un autre membre de l’ensemble de réplica.
USN_SOURCE_CLIENT_REPLICATION_MANAGEMENT La réplication est effectuée sur les systèmes clients à partir du cloud ou des serveurs. Un handle de volume n’est pas nécessaire pour définir cette valeur

VolumeHandle

Handle de volume pour cette opération.

HandleInfo

Contient des indicateurs pour identifier la demande. Ce champ peut être l’une des valeurs suivantes :

Indicateur Signification
MARK_HANDLE_PROTECT_CLUSTERS N’autorisez pas la défragmentation (FSCTL_MOVE_FILE) tant que le handle n’est pas fermé.
MARK_HANDLE_TXF_SYSTEM_LOG Ce flux est utilisé comme journal Txf pour un gestionnaire de ressources sur le volume. Doit être appelé dans le noyau à l’aide de IRP_MN_KERNEL_CALL. Disponible à partir de Windows Vista.
MARK_HANDLE_NOT_TXF_SYSTEM_LOG Ce composant n’utilise plus cet objet comme fichier journal TxF. Disponible à partir de Windows Vista.
MARK_HANDLE_REALTIME Uniquement pris en charge par le système de fichiers UDFS. Marque l’appareil pour effectuer un streaming vidéo en temps réel. Disponible à partir de Windows 7.
MARK_HANDLE_NOT_REALTIME Uniquement pris en charge par le système de fichiers UDFS. Marque l’appareil pour qu’il n’effectue plus de streaming vidéo en temps réel. Disponible à partir de Windows 7.
MARK_HANDLE_CLOUD_SYNC Déconseillée; n’utilisez pas cet indicateur.
MARK_HANDLE_READ_COPY Les données doivent être lues à partir de la copie de données spécifiée. Pris en charge uniquement pour espaces de stockage volumes redondants. Disponible à partir de Windows 8.
MARK_HANDLE_NOT_READ_COPY Les données ne doivent plus être lues à partir d’une copie spécifique. Pris en charge uniquement pour espaces de stockage volumes redondants. Disponible à partir de Windows 8.
MARK_HANDLE_FILTER_METADATA Réservé à une utilisation microsoft interne uniquement.
MARK_HANDLE_RETURN_PURGE_FAILURE Lorsque vous mélangez des E/S mappées/mises en cache avec des E/S non mises en cache, et qu’une E/S non mise en cache est émise, le système tente de vider les mappages de mémoire pour la plage des E/S non mises en cache. Si ces purges échouent, le système ne retourne normalement pas l’échec à l’appelant, ce qui peut entraîner un état endommagé. Cet indicateur indique au système de renvoyer les échecs de purge pour le handle donné afin que l’application puisse mieux gérer cette situation. Disponible à partir de Windows 8.1.
MARK_HANDLE_DISABLE_FILE_METADATA_OPTIMIZATION Désactive la fonctionnalité de compactage du service de réplication de fichiers (FRS) sur le fichier donné. Disponible à partir de Windows 10 version 1507.
MARK_HANDLE_ENABLE_USN_SOURCE_ON_PAGING_IO Indique à NTFS de définir la valeur UsnSourceInfo donnée sur les écritures de pagination dans le Journal USN. Traditionnellement, cela n’a pas été effectué sur les écritures de pagination, car vous ne savez pas quel thread a apporté les modifications données. Il s’agit d’un remplacement. Cela fonctionne uniquement si l’objet FileObject sur lequel le Gestionnaire de mémoire tient a cet état associé. Disponible à partir de Windows 10 version 1507.
MARK_HANDLE_SKIP_COHERENCY_SYNC_DISALLOW_WRITES Indique au système que les écritures ne sont pas autorisées sur ce fichier. Si quelqu’un tente d’ouvrir le fichier pour l’accès en écriture, l’opération échoue avec STATUS_ACCESS_DENIED. Si une écriture est visible, l’opération échoue avec STATUS_MARKED_TO_DISALLOW_WRITES. Disponible à partir de Windows 10 version 1507.
MARK_HANDLE_ENABLE_CPU_CACHE Réservé à une utilisation microsoft interne uniquement.
MARK_HANDLE_SUPPRESS_VOLUME_OPEN_FLUSH Normalement, lors de la première opération de lecture/écriture sur un handle de volume (DASD ouvert), le système de fichiers vide le volume. Cela peut avoir des conséquences sur les performances dans certains scénarios. Si cet indicateur est défini sur une poignée de volume, il supprime ce vidage lors de la première E/S. Disponible à partir de Windows 11.

Remarques

MARK_HANDLE_INFO contient les informations utilisées pour marquer un fichier ou un répertoire spécifié, et son numéro de séquence de mise à jour (USN) change journal record avec des données sur les modifications.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows XP
En-tête ntifs.h

Voir aussi

FSCTL_MARK_HANDLE