IoRegisterFsRegistrationChange 함수(ntifs.h)
IoRegisterFsRegistrationChange 루틴은 파일 시스템이 활성 파일 시스템으로 등록하거나 등록을 취소할 때마다 호출할 파일 시스템 필터 드라이버의 알림 루틴을 등록합니다.
구문
NTSTATUS IoRegisterFsRegistrationChange(
[in] PDRIVER_OBJECT DriverObject,
[in] PDRIVER_FS_NOTIFICATION DriverNotificationRoutine
);
매개 변수
[in] DriverObject
파일 시스템 필터 드라이버의 드라이버 개체에 대한 포인터입니다.
[in] DriverNotificationRoutine
파일 시스템이 자신을 등록하거나 등록 취소할 때 호출하는 PDRIVER_FS_NOTIFICATION 루틴에 대한 포인터입니다.
반환 값
| 반환 코드 | 설명 |
|---|---|
|
알림 루틴이 성공적으로 등록되었습니다. |
|
알림 루틴에 대해 알림 패킷을 할당할 수 없습니다. |
설명
IoRegisterFsRegistrationChange 는 파일 시스템이 IoRegisterFileSystem 또는 IoUnregisterFileSystem 을 호출할 때마다 알림을 받을 파일 시스템 필터 드라이버를 등록 합니다.
이러한 알림 수신을 중지하려면 필터 드라이버가 IoUnregisterFsRegistrationChange를 호출해야 합니다.
참고 Microsoft Windows XP 이상에서는 파일 시스템 필터 드라이버가 IoRegisterFsRegistrationChange를 호출할 때 현재 등록된 모든 파일 시스템(즉, 이미 IoRegisterFileSystem을 호출했지만 아직 IoUnregisterFileSystem을 호출하지 않은 파일 시스템)에도 해당 알림 루틴이 즉시 호출됩니다.
IoRegisterFsRegistrationChange가 반환되기 전에 호출자의 알림 루틴을 호출할 수 있으므로 필터 드라이버는 이러한 알림을 처리하는 데 필요한 데이터 구조를 만든 후에야 이 루틴을 호출할 수 있습니다.
또한 Windows XP 이상에서 IoRegisterFsRegistrationChange는 RAW 디바이스를 무시합니다. 이름으로 RAW 파일 시스템에 연결하는 방법에 대한 자세한 내용은 대상 디바이스 개체에 필터 디바이스 개체 첨부를 참조하세요.
참고 Windows 2000 SP4(서비스 팩 4), Windows XP SP2(서비스 팩 2) 및 Microsoft Windows Server 2003 SP1 이상에 대한 업데이트 롤업에서 파일 시스템 필터 드라이버가 IoRegisterFsRegistrationChange를 연속해서 두 번 호출하는 경우(그 사이에 IoUnregisterFsRegistrationChange를 호출하지 않고) DriverObject 및 DriverNotificationRoutine에 대해 동일한 값을 전달합니다. IoRegisterFsRegistrationChange에 대한 이전 호출에서 등록되었으며 첫 번째 호출 이후 다른 필터 드라이버가 등록되지 않은 경우 IoRegisterFsRegistrationChange는 STATUS_DEVICE_ALREADY_ATTACHED 반환합니다.
요구 사항
| 대상 플랫폼 | 유니버설 |
| 헤더 | ntifs.h(Ntifs.h 포함) |
| 라이브러리 | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | < DISPATCH_LEVEL |
참조
피드백
다음에 대한 사용자 의견 제출 및 보기