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 が既存のファイルの ID と一致したため、トンネリングできませんでした。 |
FILE_ACTION_TUNNELLED_ID_COLLISION | ファイルに既にオブジェクト ID があるため、ファイルのオブジェクト ID をトンネリングできませんでした。 |
[in, optional] TargetContext
ツリーが監視されている場合に走査チェックを実行する場合にファイル システムに渡すコンテキスト ポインター。 詳細については、FsRtlNotifyFullChangeDirectory の TraverseCallback パラメーターを参照してください。
戻り値
なし
解説
FsRtlNotifyFullReportChange は、保留中の通知変更 IRP を完了できるように、ファイルが変更されたときにファイル システムによって呼び出されます。
FsRtlNotifyFullReportChange は、指定されたフィルターとパス名に一致する通知構造を通知リストで検索します。 一致が見つかった場合、 FsRtlNotifyFullReportChange は、通知構造体のすべての保留中の IRP を完了します。
要件
要件 | 値 |
---|---|
対象プラットフォーム | ユニバーサル |
Header | ntifs.h (Ntifs.h を含む) |
Library | NtosKrnl.lib |
[DLL] | NtosKrnl.exe |
IRQL | PASSIVE_LEVEL |
DDI コンプライアンス規則 | HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm) |