WdfObjectReferenceWithTag 宏
[適用於 KMDF 和 UMDF]
WdfObjectReferenceWithTag 宏會遞增指定架構對象的參考計數，並將驅動程式目前的檔名和行號指派給參考。 宏也會將標記值指派給參考。
語法
VOID WdfObjectReferenceWithTag(
[in] WDFOBJECT Handle,
[in] PVOID Tag
);
參數
處理 [in]
架構物件的句柄。
標籤 [in]
架構儲存為對象參考之識別標記的驅動程式定義值。
傳回值
無。
如果驅動程式提供無效的物件句柄，就會發生錯誤檢查。
備註
如果您的驅動程式呼叫 WdfObjectReferenceWithTag 來遞增參考計數，驅動程式必須呼叫 WdfObjectDereferenceWithTag 以遞減計數。
呼叫 WdfObjectReferenceActual 或 WdfObjectReferenceWithTag 而不是 WdfObjectReference 會提供其他資訊 (標記值、行號和檔名) 給 Microsoft 調試程式。 WdfObjectReferenceActual 可讓您的驅動程式指定行號和檔名，而 WdfObjectReferenceWithTag 則使用驅動程式目前的行號和檔名。
您可以使用 ！wdftagtracker 調試程序擴展名來檢視、行號和檔名值。 調試程式延伸模組會將標記值同時顯示為指標和一系列字元。 如需調試程式擴充功能的詳細資訊，請參閱 對 KMDF 驅動程式進行偵錯。
如需對象參考計數的詳細資訊，請參閱 Framework 物件生命週期。
範例
下列程式代碼範例會遞增對象的參考計數，並將標記值指派給參考。
WdfObjectReferenceWithTag(
object,
pTag
);
規格需求
目標平台 |
Universal |
最低 KMDF 版本 |
1.0 |
最低UMDF版本 |
2.0 |
標頭 |
Wdfobject.h (包含 Wdf.h) |
媒體櫃 |
Wdf01000.sys (KMDF) ;WUDFx02000.dll (UMDF) |
IRQL |
<= DISPATCH_LEVEL |