IoRegisterFileSystem 함수(ntifs.h)

아티클
08/07/2023

IoRegisterFileSystem 루틴은 파일 시스템의 제어 디바이스 개체를 전역 파일 시스템 큐에 추가합니다.

구문

void IoRegisterFileSystem(
  [in] __drv_aliasesMem PDEVICE_OBJECT DeviceObject
);

매개 변수

[in] DeviceObject

파일 시스템의 제어 디바이스 개체에 대한 포인터입니다.

반환 값

없음

설명

IoRegisterFileSystem 은 파일 시스템의 제어 디바이스 개체를 전역 파일 시스템 큐에 삽입하여 파일 시스템을 활성 파일 시스템으로 등록하고 파일 시스템의 제어 디바이스 개체에 대한 참조 수를 증분합니다.

파일 시스템 제어 디바이스 개체의 디바이스 유형은 다음 중 하나여야 합니다.

FILE_DEVICE_NETWORK_FILE_SYSTEM

FILE_DEVICE_CD_ROM_FILE_SYSTEM

FILE_DEVICE_DISK_FILE_SYSTEM

디바이스 유형이 이러한 값 중 하나가 아니면 파일 시스템이 등록되지 않습니다.

또한 파일 시스템 제어 디바이스 개체의 이름을 지정해야 합니다. 이름이 지정되지 않으면 IoRegisterFileSystem 호출이 실패하지 않습니다. 그러나 파일 시스템 필터 드라이버와 많은 시스템 구성 요소 및 지원 루틴은 이 이름을 사용하여 항상 이름이 지정된 파일 시스템의 제어 디바이스 개체와 이름이 지정되지 않은 볼륨 디바이스 개체를 구분합니다.

파일 시스템의 제어 디바이스 개체에 DO_LOW_PRIORITY_FILESYSTEM 플래그가 설정되면 디바이스 개체가 큐의 다음 마지막 위치에 삽입됩니다. (RAW 파일 시스템은 큐의 마지막 위치를 차지합니다.) 이 플래그를 설정하지 않으면 디바이스 개체가 큐의 헤드에 삽입됩니다.

IoRegisterFileSystem 은 IoRegisterFsRegistrationChange 또는 IoRegisterFsRegistrationChangeEx 를 호출하여 이 알림에 등록된 파일 시스템 필터 드라이버의 알림 루틴을 호출 합니다.

참고 Microsoft Windows XP 이상에서는 파일 시스템 필터 드라이버가 IoRegisterFsRegistrationChange를 호출할 때 이미 IoRegisterFileSystem을 호출한 모든 파일 시스템에 대해 해당 알림 루틴이 즉시 호출됩니다.