targetRelationNeedsRef 規則 (wdm)

TargetRelationNeedsRef 規則會指定處理 TargetDeviceRelation 查詢時，驅動程式的 DispatchPnP 例程會呼叫下列其中一個函式來參考子裝置的 PDO：

• ObReferenceObject

• ObReferenceObjectByHandle

• ObReferenceObjectByPointer

只有在驅動程式將指標設定 Irp->IoStatus.Information 為新的非 NULL 值，以完成 IRP 時，才會套用此規則。 當驅動程式將 IRP 傳遞至較低的驅動程式時，不會套用它。

此規則不會指定限定為的有效值 Irp->IoStatus.Information。 只有在驅動程式變更值且新值不是 NULL 時，才會套用此規則。 有效的值是包含所要求關聯資訊之DEVICE_RELATIONS結構的指標。

此規則僅適用於總線驅動程式。

驅動程式模型：WDM

測試方法

在編譯時期
執行 靜態驅動程序驗證器 並指定 TargetRelationNeedsRef 規則。 使用下列步驟來執行程式碼的分析： 準備程式代碼 (使用角色類型宣告) 。 執行靜態驅動程式驗證程式。 檢視和分析結果。 如需詳細資訊，請參閱 使用靜態驅動程式驗證器尋找驅動程式中的瑕疵。

適用於

IoCallDriverObReferenceObjectByHandleObReferenceObjectByPointerPoCallDriver

另請參閱

DanglingDeviceObjectReference