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 |