structure MARK_HANDLE_INFO (ntifs.h)
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 |