Fungsi FsRtlNotifyFullReportChange (ntifs.h)

Artikel
08/07/2023

Rutinitas FsRtlNotifyFullReportChange selesai menunggu pemberitahuan perubahan IRP.

Sintaks

void FsRtlNotifyFullReportChange(
  [in]           PNOTIFY_SYNC NotifySync,
  [in]           PLIST_ENTRY  NotifyList,
  [in]           PSTRING      FullTargetName,
  [in]           USHORT       TargetNameOffset,
  [in, optional] PSTRING      StreamName,
  [in, optional] PSTRING      NormalizedParentName,
  [in]           ULONG        FilterMatch,
  [in]           ULONG        Action,
  [in, optional] PVOID        TargetContext
);

Parameter

[in] NotifySync

Penunjuk ke objek sinkronisasi buram untuk volume saat ini.

[in] NotifyList

Penunjuk ke kepala daftar pemberitahuan. Setiap elemen dalam daftar adalah struktur pemberitahuan buram.

[in] FullTargetName

Penunjuk ke string ANSI atau Unicode yang berisi nama jalur lengkap file.

[in] TargetNameOffset

Offset dalam string FullTargetName dari komponen akhir nama.

[in, optional] StreamName

Penunjuk opsional ke string ANSI atau Unicode yang berisi nama aliran untuk disimpan dengan nama file.

[in, optional] NormalizedParentName

Penunjuk opsional ke string ANSI atau Unicode yang berisi jalur yang sama seperti dalam string FullTargetName , tetapi dengan semua nama pendek digantikan oleh nama panjang yang sesuai.

[in] FilterMatch

Bitmask bendera yang akan dibandingkan dengan filter penyelesaian dalam struktur pemberitahuan. Jika salah satu bit yang sesuai dalam filter penyelesaian diatur, maka kondisi pemberitahuan ada. Untuk kemungkinan nilai bendera, lihat parameter CompletionFilter dari FsRtlNotifyFullChangeDirectory.

[in] Action

Menentukan kode tindakan untuk disimpan di buffer pengguna jika ada. Kode tindakan bisa menjadi salah satu nilai yang dijelaskan berikut ini.

Kode Tindakan	Makna
FILE_ACTION_ADDED	File atau subdirektori baru telah dibuat.
FILE_ACTION_REMOVED	File atau subdirektori telah dihapus.
FILE_ACTION_MODIFIED	File atau subdirektori telah dimodifikasi (tetapi tidak dibuat atau dihapus).
FILE_ACTION_RENAMED_OLD_NAME	Ini adalah nama lama file yang telah diganti namanya.
FILE_ACTION_RENAMED_NEW_NAME	Ini adalah nama baru file yang telah diganti namanya.
FILE_ACTION_ADDED_STREAM	Aliran baru telah dibuka.
FILE_ACTION_REMOVED_STREAM	Aliran telah ditutup.
FILE_ACTION_MODIFIED_STREAM	Aliran telah diubah (tetapi tidak dibuka atau ditutup).
FILE_ACTION_REMOVED_BY_DELETE	ID objek telah dihapus dari indeks oleh operasi hapus file.
FILE_ACTION_ID_NOT_TUNNELLED	ID objek untuk file tidak dapat diteruskan karena ID objeknya cocok dengan ID file yang sudah ada.
FILE_ACTION_TUNNELLED_ID_COLLISION	ID objek untuk file tidak dapat diterowongkan karena file sudah memiliki ID objek.

[in, optional] TargetContext

Penunjuk konteks untuk diteruskan ke sistem file jika melakukan pemeriksaan melintasi dalam kasus pohon yang sedang diawasi. Untuk informasi selengkapnya, lihat parameter TraverseCallback dari FsRtlNotifyFullChangeDirectory.

Mengembalikan nilai

Tidak ada

Keterangan

FsRtlNotifyFullReportChange dipanggil oleh sistem file ketika file dimodifikasi sehingga runtime integrasi perubahan yang tertunda dapat diselesaikan.

FsRtlNotifyFullReportChange mencari struktur pemberitahuan dalam daftar pemberitahuan yang cocok dengan filter dan nama jalur yang ditentukan. Jika kecocokan ditemukan, FsRtlNotifyFullReportChange menyelesaikan semua RUNP yang tertunda untuk struktur pemberitahuan.

Persyaratan

Persyaratan	Nilai
Target Platform	Universal
Header	ntifs.h (termasuk Ntifs.h)
Pustaka	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
Aturan kepatuhan DDI	HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm)

Lihat juga

FsRtlNotifyFullChangeDirectory

Bagikan melalui