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の
[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の
戻り値
何一つ
備考
FsRtlNotifyFullReportChange は、保留中の通知変更 IRP を完了できるようにファイルが変更されたときにファイル システムによって呼び出されます。
FsRtlNotifyFullReportChange は、指定されたフィルターとパス名に一致する通知構造を通知リストで検索します。 一致が見つかった場合、fsRtlNotifyFullReportChange は、通知構造のすべての保留中の IRP を完了します。
必要条件
要件 | 価値 |
---|---|
ターゲット プラットフォーム の |
万国 |
ヘッダー | ntifs.h (Ntifs.h を含む) |
ライブラリ | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | PASSIVE_LEVEL |
DDI コンプライアンス規則 を |
HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm) |