IoGetAttachedDevice 関数 (ntifs.h)

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

構文

PDEVICE_OBJECT IoGetAttachedDevice(
  [in] PDEVICE_OBJECT DeviceObject
);

[in] DeviceObject

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

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

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

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

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