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) |