FsRtlNotifyFilterChangeDirectory 함수(ntifs.h)

  • 아티클

FsRtlNotifyFilterChangeDirectory 는 IRP_MN_NOTIFY_CHANGE_DIRECTORY 요청에 대한 알림 구조를 만들고 지정된 알림 목록에 추가합니다.

구문

void FsRtlNotifyFilterChangeDirectory(
  [in]           PNOTIFY_SYNC               NotifySync,
  [in]           PLIST_ENTRY                NotifyList,
  [in]           PVOID                      FsContext,
  [in]           PSTRING                    FullDirectoryName,
  [in]           BOOLEAN                    WatchTree,
  [in]           BOOLEAN                    IgnoreBuffer,
  [in]           ULONG                      CompletionFilter,
  [in, optional] PIRP                       NotifyIrp,
  [in, optional] PCHECK_FOR_TRAVERSE_ACCESS TraverseCallback,
  [in, optional] PSECURITY_SUBJECT_CONTEXT  SubjectContext,
  [in, optional] PFILTER_REPORT_CHANGE      FilterCallback
);

매개 변수

[in] NotifySync

NotifyList 매개 변수가 가리키는 변경 디렉터리 알림 목록에 대한 불투명 동기화 개체에 대한 포인터입니다.

[in] NotifyList

현재 볼륨에 대한 변경 디렉터리 알림 목록의 헤드에 대한 포인터입니다. 목록의 각 요소는 불투명 알림 구조체입니다.

[in] FsContext

특정 파일 개체에 속하는 것으로 만들 알림 구조를 식별하기 위해 파일 시스템에서 할당한 고유 값에 대한 포인터입니다. TraverseCallback 루틴이 제공되면 FsContext가 해당 루틴에 NotifyContext 매개 변수로 전달됩니다.

[in] FullDirectoryName

이 알림 구조와 연결된 디렉터리의 전체 이름을 포함하는 ANSI 또는 유니코드 문자열에 대한 포인터입니다. NotifyIrp이 NULL이면 무시됩니다.

[in] WatchTree

이 디렉터리의 모든 하위 디렉터리도 확인해야 하는 경우 TRUE로 설정합니다. 디렉터리 자체만 감시할 경우 FALSE로 설정합니다. NotifyIrp이 NULL이면 무시됩니다.

[in] IgnoreBuffer

사용자 버퍼를 무시하고 디렉터리를 강제로 다시 열거하려면 TRUE로 설정합니다. 이 작업은 작업의 속도를 향상합니다. NotifyIrp이 NULL이면 무시됩니다.

[in] CompletionFilter

알림 목록의 IRP가 완료되도록 해야 하는 파일 또는 디렉터리에 대한 변경 유형을 지정하는 플래그의 비트 마스크입니다. 다음 표에서는 가능한 플래그 값에 대해 설명합니다.

플래그 의미
FILE_NOTIFY_CHANGE_FILE_NAME(0x0001) 파일이 이 디렉터리에서 추가, 삭제 또는 이름이 바뀌었습니다.
FILE_NOTIFY_CHANGE_DIR_NAME(0x0002) 하위 디렉터리가 생성, 제거 또는 이름이 변경되었습니다.
FILE_NOTIFY_CHANGE_NAME(0x0003) 이 디렉터리의 이름이 변경되었습니다.
FILE_NOTIFY_CHANGE_ATTRIBUTES(0x0004) 이 파일의 특성 값(예: 마지막 액세스 시간)이 변경되었습니다.
FILE_NOTIFY_CHANGE_SIZE(0x0008) 이 파일의 크기가 변경되었습니다.
FILE_NOTIFY_CHANGE_LAST_WRITE(0x0010) 이 파일의 마지막 수정 시간이 변경되었습니다.
FILE_NOTIFY_CHANGE_LAST_ACCESS(0x0020) 이 파일의 마지막 액세스 시간이 변경되었습니다.
FILE_NOTIFY_CHANGE_CREATION(0x0040) 이 파일의 생성 시간이 변경되었습니다.
FILE_NOTIFY_CHANGE_EA(0x0080) 이 파일의 확장 특성이 수정되었습니다.
FILE_NOTIFY_CHANGE_SECURITY(0x0100) 이 파일의 보안 정보가 변경되었습니다.
FILE_NOTIFY_CHANGE_STREAM_NAME(0x0200) 이 디렉터리에서 파일 스트림이 추가, 삭제 또는 이름이 변경되었습니다.
FILE_NOTIFY_CHANGE_STREAM_SIZE(0x0400) 이 파일 스트림의 크기가 변경되었습니다.
FILE_NOTIFY_CHANGE_STREAM_WRITE(0x0800) 이 파일 스트림의 데이터가 변경되었습니다.

NotifyIrp이 NULL인 경우 CompletionFilter는 무시됩니다.

[in, optional] NotifyIrp

알림 목록에 추가할 IRP에 대한 포인터입니다. NotifyIrp이 NULL이면 파일 개체(FsContext 매개 변수로 식별됨)로 표시되는 파일 스트림이 삭제되고 있음을 의미합니다.

[in, optional] TraverseCallback

디렉터리 트리에서 감시 중인 하위 디렉터리에서 변경이 발생할 때 호출할 콜백 루틴에 대한 선택적 포인터입니다. 이렇게 하면 파일 시스템에서 감시자가 해당 디렉터리에 대한 액세스 권한을 트래버스하는지 여부를 검사 수 있습니다. 이러한 호출자 제공 루틴은 다음과 같이 선언됩니다.

NTSTATUS
(*PCHECK_FOR_TRAVERSE_ACCESS) (
    IN PVOID NotifyContext,                     // FsContext
    IN PVOID TargetContext,                     // Context pointer
    IN PSECURITY_SUBJECT_CONTEXT SubjectContext // SubjectContext
    );

TargetContext 매개 변수에 대한 자세한 내용은 FsRtlNotifyFullReportChange의 TargetContext 매개 변수를 참조하세요. NotifyIrp이 NULL인 경우 TraverseCallback은 무시됩니다.

[in, optional] SubjectContext

TraverseCallback에 전달할 SECURITY_SUBJECT_CONTEXT 구조체에 대한 포인터입니다. FsRtlNotifyFilterChangeDirectory 는 컨텍스트를 해제하고 사용한 후 구조를 해제합니다. NotifyIrp이 NULL인 경우 이 매개 변수는 무시됩니다. TraverseCallback 루틴이 제공되면 SubjectContext가 해당 루틴에 SubjectContext 매개 변수로 전달됩니다.

[in, optional] FilterCallback

디렉터리 변경이 발생할 때 호출할 콜백 루틴에 대한 선택적 포인터입니다. 이 콜백 루틴이 TRUE를 반환하면 FsRtlNotifyFilterReportChange 는 알림 목록에서 보류 중인 IRP_MN_NOTIFY_CHANGE_DIRECTORY 요청을 완료합니다. 그렇지 않으면 그렇지 않습니다. 이러한 호출자 제공 루틴은 다음과 같이 선언됩니다.

BOOLEAN
(*PFILTER_REPORT_CHANGE) (
    IN PVOID NotifyContext,                     // FsContext
    IN PVOID FilterContext                      // Context pointer
    );

반환 값

없음

설명

FsRtlNotifyFilterChangeDirectory 는 주 함수 코드 IRP_MJ_DIRECTORY_CONTROL, 부 함수 코드 IRP_MN_NOTIFY_CHANGE_DIRECTORY IRP를 받은 파일 시스템에서 호출됩니다.

파일 시스템은 FsRtlNotifyFilterChangeDirectory 를 호출하여 IRP를 보유하는 알림 구조를 만들고 현재 볼륨의 알림 목록에 알림 구조를 추가합니다.

NotifyIrp이 NULL인 경우 FsRtlNotifyFilterChangeDirectory는 알림 목록에 파일 개체가 지정된 FsContext 값과 일치하는 보류 중인 IRP가 이미 포함되어 있는지 확인하고, 이 경우 STATUS_DELETE_PENDING 사용하여 IRP를 완료합니다.

NotifyIrp이 NULL이 아닌 경우 FsRtlNotifyFilterChangeDirectory는 다음을 수행합니다.

  • IRP의 파일 개체가 정리되었는지 확인합니다. 이 경우 FsRtlNotifyFilterChangeDirectory는 상태 STATUS_NOTIFY_CLEANUP 사용하여 IRP를 완료하고 알림 목록에 추가하지 않습니다.

  • IRP의 파일 개체가 정리되지 않은 경우 FsRtlNotifyFilterChangeDirectory 는 알림 목록에 지정된 FsContext 값에 대한 알림 구조가 이미 포함되어 있는지 확인합니다. 이러한 알림 구조가 발견되고 보고 보류 중인 변경 내용이 있는 경우 FsRtlNotifyFilterChangeDirectory 는 NotifyIrp을 완료합니다. 알림 구조체를 찾았지만 보고 보류 중인 변경 내용이 없는 경우 FsRtlNotifyFilterChangeDirectory 는 NotifyIrp 에서 가리키는 IRP를 보류 중으로 표시하고 알림 구조의 알림 IRP 목록에 삽입합니다. 이러한 알림 구조를 찾을 수 없는 경우 FsRtlNotifyFilterChangeDirectory 는 NotifyIrp 에서 가리키는 IRP를 보류 중으로 표시하고 알림 구조를 만들고 알림 목록에 삽입합니다.

디렉터리가 변경되면 파일 시스템은 FsRtlNotifyFilterReportChange 를 호출하여 알림 목록에서 보류 중인 IRP_MN_NOTIFY_CHANGE_DIRECTORY 요청을 완료합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 2000 SP4 업데이트 롤업; Windows XP
대상 플랫폼 유니버설
헤더 ntifs.h(Ntifs.h 포함)
라이브러리 NtosKrnl.lib
DLL NtosKrnl.exe
IRQL < APC_LEVEL
DDI 규정 준수 규칙 HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm)

추가 정보

FsRtlNotifyFilterReportChange

FsRtlNotifyFullChangeDirectory

FsRtlNotifyFullReportChange

IRP_MJ_DIRECTORY_CONTROL

SECURITY_SUBJECT_CONTEXT