Fungsi FsRtlNotifyFilterReportChange (ntifs.h)

  • Artikel

FsRtlNotifyFilterReportChange menyelesaikan IRP_MN_NOTIFY_CHANGE_DIRECTORY permintaan yang tertunda dalam daftar pemberitahuan yang ditentukan.

Sintaks

void FsRtlNotifyFilterReportChange(
  [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,
  [in, optional] PVOID        FilterContext
);

Parameter

[in] NotifySync

Penunjuk ke objek sinkronisasi buram untuk daftar pemberitahuan direktori perubahan yang diarahkan oleh parameter NotifyList .

[in] NotifyList

Penunjuk ke kepala direktori perubahan memberi tahu daftar untuk volume saat ini. Setiap elemen dalam daftar adalah struktur pemberitahuan buram.

[in] FullTargetName

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

[in] TargetNameOffset

Offset, dalam byte, dalam string FullTargetName dari komponen akhir nama file untuk file atau direktori yang berubah.

[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 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 FsRtlNotifyFilterChangeDirectory.

[in] Action

Menentukan kode tindakan untuk disimpan di buffer pengguna jika ada. Untuk kemungkinan nilai kode tindakan, lihat Parameter tindakanFsRtlNotifyFullReportChange.

[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 TraverseCallbackFsRtlNotifyFilterChangeDirectory.

[in, optional] FilterContext

Penunjuk konteks untuk diteruskan ke rutinitas panggilan balik filter. Untuk informasi selengkapnya, lihat parameter FilterCallbackFsRtlNotifyFilterChangeDirectory.

Nilai kembali

Tidak ada

Keterangan

Sistem file yang telah menerima IRP dengan kode fungsi utama IRP_MJ_DIRECTORY_CONTROL, kode fungsi kecil IRP_MN_NOTIFY_CHANGE_DIRECTORY, memanggil FsRtlNotifyFilterChangeDirectory untuk membuat struktur pemberitahuan untuk menahan IRP dan menambahkan struktur pemberitahuan ke daftar pemberitahuan untuk volume saat ini.

Ketika perubahan terjadi pada direktori, sistem file memanggil FsRtlNotifyFilterReportChange untuk menyelesaikan permintaan IRP_MN_NOTIFY_CHANGE_DIRECTORY yang tertunda dalam daftar pemberitahuan.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Rollup Pembaruan Windows 2000 SP4; Windows XP
Target Platform Universal
Header ntifs.h (termasuk Ntifs.h)
Pustaka NtosKrnl.lib
DLL NtosKrnl.exe
IRQL < APC_LEVEL
Aturan kepatuhan DDI HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm)

Lihat juga

FsRtlNotifyFilterChangeDirectory

FsRtlNotifyFullChangeDirectory

FsRtlNotifyFullReportChange

IRP_MJ_DIRECTORY_CONTROL