IoGetDeviceToVerify 関数 (ntifs.h)

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

構文

PDEVICE_OBJECT IoGetDeviceToVerify(
  [in] PETHREAD Thread
);

[in] Thread

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

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

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

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

要件	価値
サポートされる最小クライアント	Windows 2000
ターゲットプラットフォームの	万国
ヘッダー	ntifs.h (Ntifs.h を含む)
ライブラリ	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= DISPATCH_LEVEL
DDI コンプライアンス規則をする	HwStorPortProhibitedDDIs(storport), IrqlIoDispatch(wdm), PowerIrpDDis(wdm)