次の方法で共有


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

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

[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 と一致するため、トンネリングできませんでした。
FILE_ACTION_TUNNELLED_ID_COLLISION ファイルに既にオブジェクト ID があるため、ファイルのオブジェクト ID をトンネリングできませんでした。

[in, optional] TargetContext

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

戻り値

何一つ

備考

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

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

必要条件

要件 価値
ターゲット プラットフォーム の 万国
ヘッダー ntifs.h (Ntifs.h を含む)
ライブラリ NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL
DDI コンプライアンス規則 を する HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm)

関連項目

FsRtlNotifyFullChangeDirectory