FsRtlNotifyFilterReportChange 関数 (ntifs.h)

  • [アーティクル]

FsRtlNotifyFilterReportChange は、指定された通知リストで保留中の要求IRP_MN_NOTIFY_CHANGE_DIRECTORY完了します。

構文

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
);

パラメーター

[in] NotifySync

NotifyList パラメーターによって指される変更ディレクトリ通知リストの不透明な同期オブジェクトへのポインター。

[in] NotifyList

現在のボリュームの変更ディレクトリ通知リストの先頭へのポインター。 リスト内の各要素は、不透明な通知構造体です。

[in] FullTargetName

変更されたファイルまたはディレクトリの完全なパス名を含む ANSI または Unicode 文字列へのポインター。

[in] TargetNameOffset

変更されたファイルまたはディレクトリのファイル名の最後のコンポーネントの FullTargetName 文字列内のオフセット (バイト単位)。

[in, optional] StreamName

ファイル名と共に格納するストリーム名を含む ANSI または Unicode 文字列へのオプションのポインター。

[in, optional] NormalizedParentName

FullTargetName 文字列と同じパスを含み、すべての短い名前が対応する長い名前に置き換えられた ANSI または Unicode 文字列へのオプションのポインター。

[in] FilterMatch

通知構造体の完了フィルターと比較するフラグのビットマスク。 完了フィルター内の対応するビットのいずれかが設定されている場合は、通知条件が存在します。 使用可能なフラグ値については、FsRtlNotifyFilterChangeDirectory の CompletionFilter パラメーターを参照してください。

[in] Action

ユーザーのバッファーに格納するアクション コード (存在する場合) を指定します。 使用可能なアクション コード値については、FsRtlNotifyFullReportChange の Action パラメーターを参照してください。

[in, optional] TargetContext

ツリーが監視されている場合に走査チェックを実行する場合にファイル システムに渡すコンテキスト ポインター。 詳細については、FsRtlNotifyFilterChangeDirectory の TraverseCallback パラメーターを参照してください。

[in, optional] FilterContext

フィルター コールバック ルーチンに渡すコンテキスト ポインター。 詳細については、FsRtlNotifyFilterChangeDirectory の FilterCallback パラメーターを参照してください。

戻り値

なし

解説

メジャー関数コード IRP_MJ_DIRECTORY_CONTROL、マイナー関数コード IRP_MN_NOTIFY_CHANGE_DIRECTORYを持つ IRP を受信したファイル システムは、 FsRtlNotifyFilterChangeDirectory を呼び出して、IRP を保持する通知構造体を作成し、現在のボリュームの通知リストに通知構造体を追加します。

ディレクトリに変更が発生すると、ファイル システムは FsRtlNotifyFilterReportChange を呼び出して、通知リストの保留中のIRP_MN_NOTIFY_CHANGE_DIRECTORY要求を完了します。

要件

要件 値
サポートされている最小のクライアント Windows 2000 SP4 更新プログラムのロールアップ。Windows XP
対象プラットフォーム ユニバーサル
Header ntifs.h (Ntifs.h を含む)
Library NtosKrnl.lib
[DLL] NtosKrnl.exe
IRQL < APC_LEVEL
DDI コンプライアンス規則 HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm)

こちらもご覧ください

FsRtlNotifyFilterChangeDirectory

FsRtlNotifyFullChangeDirectory

FsRtlNotifyFullReportChange

IRP_MJ_DIRECTORY_CONTROL