IoEnumerateDeviceObjectList 関数 (ntifs.h)

[アーティクル]
03/08/2023

IoEnumerateDeviceObjectList ルーチンは、ドライバーのデバイスオブジェクトリストを列挙します。

構文

NTSTATUS IoEnumerateDeviceObjectList(
  [in]  PDRIVER_OBJECT DriverObject,
  [out] PDEVICE_OBJECT *DeviceObjectList,
  [in]  ULONG          DeviceObjectListSize,
  [out] PULONG         ActualNumberDeviceObjects
);

パラメーター

[in] DriverObject

ドライバーのドライバーオブジェクトへのポインター。

[out] DeviceObjectList

デバイスオブジェクトポインターを受け取る呼び出し元によって割り当てられた配列へのポインター。この配列は、非ページプールから割り当てる必要があります。このパラメーターは、NULL でもかまいません。「解説」を参照してください。

[in] DeviceObjectListSize

DeviceObjectList 配列のサイズ (バイト単位)。このパラメーターには 0 を指定できます。「解説」を参照してください。

[out] ActualNumberDeviceObjects

ドライバーオブジェクトのデバイスオブジェクトの一覧で見つかったデバイスオブジェクトの実際の数。 DeviceObjectList の配列が小さすぎる場合、配列にコピーされるデバイスオブジェクトポインターの数は ActualNumberDeviceObjects より小さくなります。

戻り値

IoEnumerateDeviceObjectList は、次のいずれかの値などの NTSTATUS コードを返します。

リターンコード	説明
STATUS_SUCCESS	IoEnumerateDeviceObjectList の呼び出しが正常に完了しました。
STATUS_BUFFER_TOO_SMALL	DeviceObjectList の配列が小さすぎて、デバイスオブジェクトリスト全体を保持できません。この場合、 IoEnumerateDeviceObjectList は、可能な限り多くのデバイスオブジェクトポインターを配列にコピーします。

注釈

ファイルシステムフィルタードライバーは 、IoEnumerateDeviceObjectList を呼び出して次を列挙します。

作成したデバイスオブジェクト。これは通常、ドライバーがアンロードの準備をしているときに行われます。フィルタードライバーは、実行中のシステムから安全にアンロードできないことに注意してください。詳細については、「 ZwUnloadDriver」を参照してください。
基本ファイルシステムによって作成されたデバイスオブジェクト。そのため、フィルターはアタッチできるボリュームの数を認識します。

IoEnumerateDeviceObjectList は、フィルタードライバーによって作成されたすべてのデバイスオブジェクトを返します。これには、コントロールデバイスオブジェクト (CTO) とボリュームデバイスオブジェクト (VTO) が含まれます。 2 種類のデバイスオブジェクトは、規則によって、CTO に名前が付けられ、VTO が名前付けされないという事実によって区別できます。

後者の場合、フィルタードライバーは通常 、IoEnumerateDeviceObjectList を 2 回呼び出します。1 回はリスト内のデバイスオブジェクトの数を取得し、1 回はデバイスオブジェクトリスト自体を取得します。最初の呼び出しでは、呼び出し元は DeviceObjectList パラメーターを NULL に、 DeviceObjectListSize を 0 に設定する必要があります。 2 番目の呼び出しでは、 DeviceObjectList に適切なサイズのポインター配列へのポインターが含まれている必要があり、 DeviceObjectListSize にはその配列のサイズ (バイト単位) が含まれている必要があります。

IoEnumerateDeviceObjectList は、 DeviceObjectList が指すリスト内のすべてのデバイスオブジェクトの参照カウントをインクリメントします。したがって、 IoEnumerateDeviceObjectList の呼び出しが成功するたびに、一覧内の各デバイスオブジェクトに対する ObDereferenceObject の後続の呼び出しと一致する必要があります。これを行わないと、未処理の参照カウントが原因で、システムがこれらのデバイスオブジェクトを解放または削除できなくなります。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 SP4 更新プログラムのロールアップ。Windows XP
対象プラットフォーム	ユニバーサル
Header	ntifs.h (Ntifs.h を含む)
Library	NtosKrnl.lib
[DLL]	NtosKrnl.exe
IRQL	<= DISPATCH_LEVEL