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 (include Ntifs.h) |
連結庫 | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | < DISPATCH_LEVEL |