FsRtlNotifyFullReportChange 関数 (ntifs.h)

FsRtlNotifyFullReportChange ルーチンは、保留中の通知変更 IRP を完了します。

構文

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

パラメーター

[in] NotifySync

現在のボリュームの不透明な同期オブジェクトへのポインター。

[in] NotifyList

通知リストの先頭へのポインター。 リスト内の各要素は、不透明な通知構造体です。

[in] FullTargetName

ファイルの完全なパス名を含む ANSI または Unicode 文字列へのポインター。

[in] TargetNameOffset

名前の最後のコンポーネントの FullTargetName 文字列内のオフセット。

[in, optional] StreamName

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

[in, optional] NormalizedParentName

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

[in] FilterMatch

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

[in] Action

ユーザーのバッファーに格納するアクション コード (存在する場合) を指定します。 アクション コードには、次に示す値のいずれかを指定できます。

アクション コード 意味
FILE_ACTION_ADDED 新しいファイルまたはサブディレクトリが作成されました。
FILE_ACTION_REMOVED ファイルまたはサブディレクトリが削除されました。
FILE_ACTION_MODIFIED ファイルまたはサブディレクトリが変更されました (ただし、作成または削除されていません)。
FILE_ACTION_RENAMED_OLD_NAME これは、名前が変更されたファイルの古い名前です。
FILE_ACTION_RENAMED_NEW_NAME これは、名前が変更されたファイルの新しい名前です。
FILE_ACTION_ADDED_STREAM 新しいストリームが開かれました。
FILE_ACTION_REMOVED_STREAM ストリームが閉じられました。
FILE_ACTION_MODIFIED_STREAM ストリームが変更されました (ただし、開かれたも閉じていません)。
FILE_ACTION_REMOVED_BY_DELETE ファイルの削除操作によって、オブジェクト ID がインデックスから削除されました。
FILE_ACTION_ID_NOT_TUNNELLED ファイルのオブジェクト ID は、そのオブジェクト ID が既存のファイルの ID と一致したため、トンネリングできませんでした。
FILE_ACTION_TUNNELLED_ID_COLLISION ファイルに既にオブジェクト ID があるため、ファイルのオブジェクト ID をトンネリングできませんでした。

[in, optional] TargetContext

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

戻り値

なし

解説

FsRtlNotifyFullReportChange は、保留中の通知変更 IRP を完了できるように、ファイルが変更されたときにファイル システムによって呼び出されます。

FsRtlNotifyFullReportChange は、指定されたフィルターとパス名に一致する通知構造を通知リストで検索します。 一致が見つかった場合、 FsRtlNotifyFullReportChange は、通知構造体のすべての保留中の IRP を完了します。

要件

要件
対象プラットフォーム ユニバーサル
Header ntifs.h (Ntifs.h を含む)
Library NtosKrnl.lib
[DLL] NtosKrnl.exe
IRQL PASSIVE_LEVEL
DDI コンプライアンス規則 HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm)

こちらもご覧ください

FsRtlNotifyFullChangeDirectory