TargetRelationNeedsRef ルール (wdm)

  • [アーティクル]

TargetRelationNeedsRef ルールは、 TargetDeviceRelation クエリを処理するときに、ドライバーの DispatchPnP ルーチンが次のいずれかの関数を呼び出して子デバイスの PDO を参照することを指定します。

この規則は、ドライバーが新しいNULL 以外の値への Irp->IoStatus.Information ポインターを設定することによって IRP を完了する場合にのみ適用されます。 ドライバーが下位のドライバーに IRP を渡すときは適用されません。

この規則では、有効な値 Irp->IoStatus.Informationとして修飾するものは指定されません。 この規則は、ドライバーが値を変更し、新しい値が NULL でない場合にのみ適用されます。 有効な値は、要求されたリレーション情報を含むDEVICE_RELATIONS構造体へのポインターです。

この規則は、バス ドライバーにのみ適用されます。

ドライバーモデル: WDM

テスト方法

コンパイル時

静的ドライバー検証 を実行し、 TargetRelationNeedsRef 規則を指定します。

コードの分析を実行するには、次の手順に従います。
  1. コードを準備します (ロール型宣言を使用します)。
  2. 静的ドライバー検証ツールを実行します。
  3. 結果を表示および分析します。

詳細については、 「静的ドライバー検証ツールを使用してドライバー の欠陥を見つける」を参照してください。

適用対象

IoCallDriverObReferenceObjectByHandleObReferenceObjectByPointerPoCallDriver

関連項目

DanglingDeviceObjectReference