IoVerifyVolume 함수(ntifs.h)

  • 아티클

IoVerifyVolume 은 디바이스 개체로 식별된 지정된 이동식 미디어 디바이스에 볼륨 확인 요청을 보냅니다.

구문

NTSTATUS IoVerifyVolume(
  [in] PDEVICE_OBJECT DeviceObject,
  [in] BOOLEAN        AllowRawMount
);

매개 변수

[in] DeviceObject

볼륨을 확인/탑재할 디바이스의 디바이스 개체를 식별하는 DEVICE_OBJECT 구조체에 대한 포인터입니다.

[in] AllowRawMount

TRUE 값은 이 확인 요청이 DASD(직접 액세스 스토리지 디바이스) 열린 요청을 대신하여 발급되고 있음을 나타내며, 이는 확인 요청이 실패할 경우 원시 탑재를 수행해야 했음을 나타냅니다.

반환 값

IoVerifyVolume 은 다음 값 중 하나일 수 있는 확인 작업에서 NTSTATUS 코드를 반환합니다.

반환 코드 설명
STATUS_SUCCESS IoVerifyVolume 은 볼륨이 변경되지 않았거나 이전에 탑재되지 않았다고 확인했습니다.
STATUS_INSUFFICIENT_RESOURCES 작업을 완료하는 데 시스템 리소스가 부족합니다.
STATUS_UNSUCCESSFUL 확인 작업이 실패했습니다.
STATUS_WRONG_VOLUME 볼륨이 변경되었습니다.

설명

IoSetDeviceToVerify 및 IoVerifyVolume을 사용하기 전에 드라이버 작성자는 FASTFAT 샘플에서 이러한 루틴을 사용하는 방법을 연구해야 합니다.

IoVerifyVolume은 볼륨이 마지막으로 액세스한 후 변경되었을 수 있는 것처럼 보일 때 지정된 디바이스에 탑재된 볼륨을 검사 위해 호출됩니다. 파일 시스템 드라이버는 일반적으로 하위 디바이스가 STATUS_VERIFY_REQUIRED 반환할 때 IoSetDeviceToVerify 및 IoVerifyVolume 을 호출합니다.

DeviceObject에 탑재된 볼륨이 있는 경우 IoVerifyVolume은 볼륨이 변경되었는지 확인합니다.

볼륨이 변경되었거나 이전에 탑재되지 않은 경우 IoVerifyVolume 은 디바이스에 볼륨 탑재 요청을 보냅니다.

이동식 미디어 디바이스에 대한 자세한 내용은 이동식 미디어 지원을 참조하세요.

요구 사항

요구 사항 값
대상 플랫폼 유니버설
헤더 ntifs.h(Ntifs.h 포함)
라이브러리 NtosKrnl.lib
DLL NtosKrnl.exe
IRQL < DISPATCH_LEVEL

추가 정보

IoGetDeviceToVerify

IoSetDeviceToVerify