IoGetAttachedDevice 関数 (ntifs.h)

IoGetAttachedDevice ルーチンは、指定したデバイスに関連付けられている最上位のデバイスオブジェクトへのポインターを返します。

構文

PDEVICE_OBJECT IoGetAttachedDevice(
  [in] PDEVICE_OBJECT DeviceObject
);

[in] DeviceObject

最上位の接続デバイスが返されるデバイスオブジェクトへのポインター。

IoGetAttachedDevice は、指定されたデバイスに接続されている最上位レベルのデバイスを返します。

DeviceObject で指定されたデバイスオブジェクトに他のデバイスオブジェクトがアタッチされていない場合は、DeviceObject し、返されるポインターは等しくなります。

IoGetAttachedDevice は、次の点で IoGetAttachedDeviceReferenceとは異なります。

IoGetAttachedDevice は、デバイスオブジェクトの参照カウントをインクリメントしません。 (したがって、obDereferenceObject一致する呼び出しは必要ありません)。
IoGetAttachedDevice の呼び出し元は、IoGetAttachedDevice の実行中 デバイスオブジェクトがスタックに追加されたりスタックから削除されたりしないようにする必要があります。これを行うことができない呼び出し元は、代わりに IoGetAttachedDeviceReference使用する必要があります。