structure MARK_HANDLE_INFO (ntifs.h)
Une structure MARK_HANDLE_INFO est passée en tant que mémoire tampon d’entrée pendant 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 :
| Drapeau | 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 depuis le stockage externe. |
| USN_SOURCE_AUXILIARY_DATA | Le service ne modifie pas l’affichage 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 du jeu de réplicas. |
| 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 requête. Ce champ peut être l’une des valeurs suivantes :
| Drapeau | Signification |
|---|---|
| MARK_HANDLE_PROTECT_CLUSTERS | N’autorisez aucune défragmentation (FSCTL_MOVE_FILE) tant que la poignée n’est pas fermée. |
| 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 le streaming en temps réel de la vidéo. Disponible à partir de Windows 7. |
| MARK_HANDLE_NOT_REALTIME | Uniquement pris en charge par le système de fichiers UDFS. Marque l’appareil pour ne plus diffuser en temps réel la vidéo. Disponible à partir de Windows 7. |
| MARK_HANDLE_CLOUD_SYNC | Obsolescent; n’utilisez pas cet indicateur. |
| MARK_HANDLE_READ_COPY | Les données doivent être lues à partir de la copie spécifiée de données. Uniquement pris en charge pour les volumes redondants espaces de stockage. Disponible à partir de Windows 8. |
| MARK_HANDLE_NOT_READ_COPY | Les données ne doivent plus être lues à partir d’une copie spécifique. Uniquement pris en charge pour les volumes redondants espaces de stockage. Disponible à partir de Windows 8. |
| MARK_HANDLE_FILTER_METADATA | Réservé uniquement pour l’utilisation interne de Microsoft. |
| MARK_HANDLE_RETURN_PURGE_FAILURE | Lors du mélange des E/S mappés/mis en cache avec des E/S non mis en cache et qu’un E/S non mis en cache est émis, le système tente de vider les mappages de mémoire pour la plage d’E/S non mis en cache. Si ces purges échouent normalement, le système ne retourne pas l’échec à l’appelant, ce qui peut entraîner une corruption de l’état. Cet indicateur indique au système de retourner des échecs de vidage 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 FRS (File Record Segment) 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 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 le FileObject sur lequel le Gestionnaire de mémoire est en attente 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 vue, l’opération a échoué avec STATUS_MARKED_TO_DISALLOW_WRITES. Disponible à partir de Windows 10 version 1507. |
| MARK_HANDLE_ENABLE_CPU_CACHE | Réservé uniquement pour l’utilisation interne de Microsoft. |
| 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 un handle de volume, il supprime cette vidage sur 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 enregistrement de journal de modification de numéro de séquence de mise à jour (USN) avec des données sur les modifications.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows XP |
| d’en-tête | ntifs.h |