IoGetDeviceAttachmentBaseRef 関数 (ntifs.h)

[アーティクル]
02/26/2024

IoGetDeviceAttachmentBaseRef ルーチンは、ファイルシステムまたはデバイスドライバースタック内の最下位レベルのデバイスオブジェクトへのポインターを返します。

構文

PDEVICE_OBJECT IoGetDeviceAttachmentBaseRef(
  [in] PDEVICE_OBJECT DeviceObject
);

パラメーター

[in] DeviceObject

スタック内のデバイスオブジェクトへのポインター。

戻り値

IoGetDeviceAttachmentBaseRef は 、ファイルシステムまたはデバイスドライバースタックの下部にあるデバイスオブジェクトへのポインターを返します。指定されたデバイスオブジェクトがドライバースタックにアタッチされていない場合、 IoGetDeviceAttachmentBaseRef はDeviceObject のデバイスオブジェクトポインターを返します。

注釈

ファイルシステムフィルタードライバーは通常 、IoGetDeviceAttachmentBaseRef を呼び出して、ファイルシステムドライバースタック内の最下位レベルのデバイスオブジェクトを取得します。多くの場合、これは、フィルタードライバーが、ファイルシステムが自身をアクティブなファイルシステムとして登録または登録解除したことを示す通知を受け取ったときに行われます。フィルタードライバーの通知コールバックルーチンは 、IoGetDeviceAttachmentBaseRef を呼び出してファイルシステムのコントロールデバイスオブジェクトへのポインターを取得し、 ObQueryNameString を呼び出して、デバッグのためにこのオブジェクトの名前を取得します。

IoGetDeviceAttachmentBaseRef は 、スタックの下部にあるデバイスオブジェクトの参照カウントをインクリメントします。したがって、 IoGetDeviceAttachmentBaseRef の呼び出しが成功するたびに、 ObDereferenceObject の後続の呼び出しと一致する必要があります。

要件

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