IoGetDeviceToVerify 関数 (ntifs.h)

IoGetDeviceToVerify ルーチンは、指定されたスレッドの I/O 要求のターゲットであるリムーバブル メディア デバイスを表すデバイス オブジェクトへのポインターを返します。

構文

PDEVICE_OBJECT IoGetDeviceToVerify(
  [in] PETHREAD Thread
);

パラメーター

[in] Thread

デバイス オブジェクトのクエリが実行されている ETHREAD 構造体へのポインター。 つまり、 Thread は、最上位レベルのドライバーが、スレッドがファイルを開いたメディアの有効性を検証しようとしているスレッドです。

戻り値

IoGetDeviceToVerify は、メディアを検証する必要があるデバイスを表すデバイス オブジェクトを識別する DEVICE_OBJECT 構造体へのポインターを返します。 この関数は NULL を返すことができます。

注釈

一般に、最上位レベルのドライバー (特にファイル システム) は、このルーチンを呼び出す可能性が最も高くなります。

基になるリムーバブル メディア デバイス ドライバーは、ターゲット デバイスへの最後のアクセス以降にメディアが変更されたと思われる場合に、上位レベルのドライバー (特にファイル システム) に通知する役割を担います。 詳細については、「 考えられるメディア変更のファイル システムへの通知」を参照してください。

要件

要件
サポートされている最小のクライアント Windows 2000
対象プラットフォーム ユニバーサル
Header ntifs.h (Ntifs.h を含む)
Library NtosKrnl.lib
[DLL] NtosKrnl.exe
IRQL <= DISPATCH_LEVEL
DDI コンプライアンス規則 HwStorPortProhibitedDDIs(storport), IrqlIoDispatch(wdm), PowerIrpDDis(wdm)

こちらもご覧ください

IoIsErrorUserInduced

IoSetDeviceToVerify

IoSetHardErrorOrVerifyDevice

PsGetCurrentThread