struktur MARK_HANDLE_INFO (ntifs.h)

Struktur MARK_HANDLE_INFO diteruskan sebagai buffer input selama permintaan kode kontrol FSCTL_MARK_HANDLE .

Sintaks

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

Anggota

DUMMYUNIONNAME

DUMMYUNIONNAME.UsnSourceInfo

Lihat UsnSourceInfo di bawah ini.

DUMMYUNIONNAME.CopyNumber

Mengidentifikasi salinan file mana yang akan dibaca, saat membaca dari file yang berada di media redundan.

UsnSourceInfo

Bendera info sumber nomor urutan pembaruan opsional (USN). Untuk mengatur salah satu nilai ini, handel DASD volume harus ditentukan di bidang VolumeHandle . Bisa berupa kombinasi dari nilai berikut:

Bendera	Makna
USN_SOURCE_DATA_MANAGEMENT	Layanan tidak memodifikasi tampilan eksternal dari bagian mana pun dari file. Kasus umumnya adalah HSM memindahkan data ke dan dari penyimpanan eksternal.
USN_SOURCE_AUXILIARY_DATA	Layanan tidak memodifikasi tampilan eksternal file sehubungan dengan aplikasi yang membuat file ini. Dapat digunakan untuk menambahkan aliran data privat ke file.
USN_SOURCE_REPLICATION_MANAGEMENT	Layanan memodifikasi file agar sesuai dengan konten file yang sama yang ada di anggota lain dari set replika.
USN_SOURCE_CLIENT_REPLICATION_MANAGEMENT	Replikasi sedang dilakukan pada sistem klien baik dari cloud atau server. Handel volume tidak diperlukan untuk mengatur nilai ini

VolumeHandle

Handel volume untuk operasi ini.

HandleInfo

Berisi bendera untuk mengidentifikasi permintaan. Bidang ini bisa menjadi salah satu nilai berikut:

Bendera	Makna
MARK_HANDLE_PROTECT_CLUSTERS	Jangan izinkan defragmentasi (FSCTL_MOVE_FILE) hingga handel ditutup.
MARK_HANDLE_TXF_SYSTEM_LOG	Aliran ini sedang digunakan sebagai log Txf untuk manajer sumber daya pada volume. Harus dipanggil di kernel menggunakan IRP_MN_KERNEL_CALL. Tersedia mulai dari Windows Vista.
MARK_HANDLE_NOT_TXF_SYSTEM_LOG	Komponen ini tidak lagi menggunakan objek ini sebagai file log TxF. Tersedia mulai dari Windows Vista.
MARK_HANDLE_REALTIME	Hanya didukung oleh sistem file UDFS. Menandai perangkat untuk melakukan streaming video secara realtime. Tersedia mulai dari Windows 7.
MARK_HANDLE_NOT_REALTIME	Hanya didukung oleh sistem file UDFS. Menandai perangkat untuk tidak lagi melakukan streaming video realtime. Tersedia mulai dari Windows 7.
MARK_HANDLE_CLOUD_SYNC	Usang; jangan gunakan bendera ini.
MARK_HANDLE_READ_COPY	Data harus dibaca dari salinan data yang ditentukan. Hanya didukung untuk volume redundan Storage Spaces. Tersedia mulai dari Windows 8.
MARK_HANDLE_NOT_READ_COPY	Data tidak lagi dibaca dari salinan tertentu. Hanya didukung untuk volume redundan Storage Spaces. Tersedia mulai dari Windows 8.
MARK_HANDLE_FILTER_METADATA	Hanya dicadangkan untuk penggunaan internal Microsoft.
MARK_HANDLE_RETURN_PURGE_FAILURE	Saat melakukan intermixing IO memori yang dipetakan/di-cache dengan IO yang tidak di-cache, dan IO yang tidak di-cache dikeluarkan, sistem mencoba menghapus menyeluruh pemetaan memori untuk rentang IO yang tidak di-cache. Jika pembersihan ini gagal, sistem biasanya tidak mengembalikan kegagalan ke pemanggil yang dapat menyebabkan status rusak. Bendera ini memberi tahu sistem untuk mengembalikan kegagalan pembersihan untuk handel yang diberikan sehingga aplikasi dapat menangani situasi ini dengan lebih baik. Tersedia mulai dari Windows 8.1.
MARK_HANDLE_DISABLE_FILE_METADATA_OPTIMIZATION	Menonaktifkan fitur pemadatan Layanan Replikasi File (FRS) pada file yang diberikan. Tersedia mulai Windows 10 versi 1507.
MARK_HANDLE_ENABLE_USN_SOURCE_ON_PAGING_IO	Memberi tahu NTFS untuk mengatur nilai UsnSourceInfo yang diberikan pada penulisan Paging di Journal USN. Secara tradisional ini tidak dilakukan pada penulisan halaman karena Anda tidak tahu utas apa yang membuat perubahan yang diberikan. Ini adalah penimpaan. Ini hanya berfungsi jika FileObject yang dipegang Oleh Manajer Memori memiliki status ini yang terkait dengannya. Tersedia mulai Windows 10 versi 1507.
MARK_HANDLE_SKIP_COHERENCY_SYNC_DISALLOW_WRITES	Memberi tahu sistem bahwa penulisan tidak diperbolehkan pada file ini. Jika seseorang mencoba membuka file untuk akses tulis, operasi gagal dengan STATUS_ACCESS_DENIED. Jika penulisan terlihat operasi gagal dengan STATUS_MARKED_TO_DISALLOW_WRITES. Tersedia mulai Windows 10 versi 1507.
MARK_HANDLE_ENABLE_CPU_CACHE	Hanya dicadangkan untuk penggunaan internal Microsoft.
MARK_HANDLE_SUPPRESS_VOLUME_OPEN_FLUSH	Biasanya, pada operasi baca/tulis pertama pada handel volume (DASD terbuka), sistem file membersihkan volume. Ini dapat memiliki konsekuensi performa dalam skenario tertentu. Jika bendera ini diatur pada handel volume, bendera ini akan menekan flush tersebut pada IO pertama. Tersedia mulai dari Windows 11.

Keterangan

MARK_HANDLE_INFO berisi informasi yang digunakan untuk menandai file atau direktori tertentu, dan nomor urutan pembaruan (USN) mengubah catatan jurnal dengan data tentang perubahan.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP
Header	ntifs.h

Lihat juga

FSCTL_MARK_HANDLE