共用方式為

WdfObjectDereferenceWithTag 宏

  • 發行項

[適用於 KMDF 和 UMDF]

WdfObjectDereferenceWithTag 宏會遞減指定架構對象的參考計數，並將驅動程式目前的檔名和行號指派給參考。 此宏也會將標記值指派給參考。

語法

VOID WdfObjectDereferenceWithTag(
  [in] WDFOBJECT Handle,
  [in] PVOID     Tag
);

參數

句柄 [in]
架構物件的句柄。

標籤 [in]
識別物件參考的驅動程式定義值。 卷標值必須符合驅動程式先前提供給 WdfObjectReferenceWithTag 的標籤。

傳回值

無。

如果驅動程式提供無效的物件句柄，就會發生錯誤檢查。

備註

如果對象的參考計數變成零，在 WdfObjectDereferenceWithTag 傳回之前，可能會刪除物件。

呼叫 WdfObjectDereferenceActual 或 WdfObjectDereferenceWithTag ，而不是 WdfObjectDereference 會提供其他資訊， (標記字串、行號和檔名) 給 Microsoft 調試程式。 WdfObjectDereferenceActual 可讓您的驅動程式指定行號和檔名，而 WdfObjectDereferenceWithTag 則使用驅動程式目前的行號和檔名。

您可以使用 ！wdftagtracker 調試程序擴展名來檢視卷標、行號和檔名值。 調試程式延伸模組會將標籤值顯示為指標和一系列字元。 如需調試程式延伸模組的詳細資訊，請參閱 對 KMDF 驅動程式進行偵錯。

如需對象參考計數的詳細資訊，請參閱 Framework 物件生命週期。

範例

下列程式代碼範例會遞減對象的參考計數，並將標記值指派給參考。

WdfObjectDereferenceWithTag(
                            object,
                            pTag
                            );

規格需求

目標平台

 Universal

最小 KMDF 版本

1.0

最低UMDF版本

2.0

標頭

 Wdfobject.h (包含 Wdf.h)

媒體櫃

 Wdf01000.sys (KMDF) ;WUDFx02000.dll (UMDF)

IRQL

<= DISPATCH_LEVEL

另請參閱

WdfObjectDereference

WdfObjectReferenceWithTag