ioVerifyVolume 函式 (ntifs.h)

IoVerifyVolume 會將磁碟區驗證要求傳送至裝置對象所識別的指定抽取式媒體裝置。

語法

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

[in] DeviceObject

DEVICE_OBJECT結構的指標，識別磁碟區要驗證/掛接之裝置的裝置物件。

[in] AllowRawMount

TRUE 值表示此驗證要求是代表 DASD 發出， (直接存取記憶體裝置) 開啟要求，這表示如果驗證要求失敗，就應該執行原始掛接。

IoVerifyVolume 會從驗證作業傳回 NTSTATUS 程式代碼，這可能是下列其中一個值：

傳回碼	Description
STATUS_SUCCESS	IoVerifyVolume 判斷磁碟區尚未變更或先前未掛接。
STATUS_INSUFFICIENT_RESOURCES	系統資源不足，無法完成作業。
STATUS_UNSUCCESSFUL	驗證作業失敗。
STATUS_WRONG_VOLUME	磁碟區已變更。

在使用 IoSetDeviceToVerify 和 IoVerifyVolume之前，驅動程式寫入器應該先研究 FASTFAT範例中使用這些例程的方式。

呼叫 IoVerifyVolume 以檢查指定裝置上掛接的磁碟區，當磁碟區在上次存取之後可能已經變更。文件系統驅動程式通常會在較低裝置傳回STATUS_VERIFY_REQUIRED時呼叫 IoSetDeviceToVerify 和 IoVerifyVolume 。

如果 DeviceObject 有掛接的磁碟區， IoVerifyVolume 會檢查磁碟區是否已變更。

如果磁碟區已變更或先前尚未掛接， IoVerifyVolume 會將磁碟區掛接要求傳送至裝置。

如需可移動媒體裝置的詳細資訊，請參閱支援卸載式媒體。