次の方法で共有

IoVerifyVolume 関数 (ntifs.h)

  • [アーティクル]

IoVerifyVolume 、デバイス オブジェクトによって識別された指定されたリムーバブル メディア デバイスにボリューム検証要求を送信します。

構文

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

パラメーター

[in] DeviceObject

ボリュームを検証/マウントするデバイスのデバイス オブジェクトを識別する DEVICE_OBJECT 構造体へのポインター。

[in] AllowRawMount

値 TRUE は、この検証要求が、検証要求が失敗した場合に生のマウントを実行する必要があることを示す、OID (ダイレクト アクセス ストレージ デバイス) のオープン要求に代わって発行されていることを示します。

戻り値

IoVerifyVolume は、検証操作から NTSTATUS コードを返します。これは、次のいずれかの値になります。

リターン コード 形容
STATUS_SUCCESS IoVerifyVolume 、ボリュームが変更されていないか、以前にマウントされていないことが確認されました。
STATUS_INSUFFICIENT_RESOURCES 操作を完了するためのシステム リソースが不足しています。
STATUS_UNSUCCESSFUL 検証操作が失敗しました。
STATUS_WRONG_VOLUME ボリュームが変更されました。

備考

IoSetDeviceToVerifyと IoVerifyVolume 使用する前に、ドライバー ライターは、FASTFAT サンプルでこれらのルーチンを使用する方法を調べる必要があります。

IoVerifyVolume が呼び出され、最後にアクセスされてからボリュームが変更された可能性がある場合に、指定したデバイスにマウントされたボリュームが確認されます。 ファイル システム ドライバーは通常、IoSetDeviceToVerify呼び出し、下位デバイスがSTATUS_VERIFY_REQUIREDを返すときに IoVerifyVolume を します。

DeviceObject にマウントされたボリュームがある場合は、IoVerifyVolume 、ボリュームが変更されたかどうかを確認します。

ボリュームが変更されたか、以前にマウントされていない場合は、IoVerifyVolume デバイスにボリューム マウント要求を送信します。

リムーバブル メディア デバイスの詳細については、「リムーバブル メディア のサポート」を参照してください。

必要条件

要件 価値
ターゲット プラットフォーム の 万国
ヘッダー ntifs.h (Ntifs.h を含む)
ライブラリ NtosKrnl.lib
DLL NtosKrnl.exe
IRQL < DISPATCH_LEVEL

関連項目

IoGetDeviceToVerifyの

IoSetDeviceToVerifyの