WdfObjectReferenceWithTag makrosu

[KMDF ve UMDF için geçerlidir]

WdfObjectReferenceWithTag makrosu, belirtilen bir çerçeve nesnesi için başvuru sayısını artırır ve sürücünün geçerli dosya adını ve satır numarasını başvuruya atar. Makro ayrıca başvuruya bir etiket değeri atar.

Sözdizimi

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

Parametreler

tanıtıcı [in]
Çerçeve nesnesinin tanıtıcısı.

Etiket [in]
Çerçevenin nesne başvurusu için bir tanımlama etiketi olarak depolandığı sürücü tanımlı değer.

Dönüş değeri

Yok.

Sürücü geçersiz bir nesne tanıtıcısı sağladığında bir hata denetimi oluşur.

Açıklamalar

Sürücünüz bir başvuru sayısını artırmak için WdfObjectReferenceWithTag çağırırsa, sayıyı azaltması için WdfObjectDereferenceWithTagçağırmalıdır.

WdfObjectReferenceyerine WdfObjectReferenceActual veyaWdfObjectReferenceWithTag çağrılması, Microsoft hata ayıklayıcılarına ek bilgiler (etiket değeri, satır numarası ve dosya adı) sağlar. WdfObjectReferenceActual sürücünüzün satır numarasını ve dosya adını belirtmesine izin verirken, WdfObjectReferenceWithTag sürücünün geçerli satır numarasını ve dosya adını kullanır.

!wdftagtracker hata ayıklayıcısı uzantısını kullanarak etiket, satır numarası ve dosya adı değerlerini görüntüleyebilirsiniz. Hata ayıklayıcısı uzantısı, etiket değerini hem işaretçi hem de karakter dizisi olarak görüntüler. Hata ayıklayıcı uzantıları hakkında daha fazla bilgi için bkz. KMDF Sürücüsünde Hata Ayıklama.

Nesne başvuru sayıları hakkında daha fazla bilgi için bkz. Framework Nesne Yaşam Döngüsü.

Örnekler

Aşağıdaki kod örneği, bir nesnenin başvuru sayısını artırır ve başvuruya bir etiket değeri atar.

WdfObjectReferenceWithTag(
                          object,
                          pTag
                          );

Gereksinimler

Hedef platform	Evrensel
En düşük KMDF sürümü	1.0
En düşük UMDF sürümü	2.0
Başlık	Wdfobject.h (Wdf.h dahil)
Kütüphane	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	<= SEVK_SEVİYESİ

Ayrıca bkz.

WdfObjectReference