WdfObjectDereferenceWithTag makrosu

[KMDF ve UMDF için geçerlidir]

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

Sözdizimi

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

Parametreler

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

Etiket [in]
Nesne başvurularını tanımlayan sürücü tanımlı değer. Etiket değeri, sürücünün WdfObjectReferenceWithTagiçin daha önce sağladığı bir etiket değeriyle eşleşmelidir.

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

Nesnenin başvuru sayısı sıfır olursa, nesne WdfObjectDereferenceWithTag döndürülmeden önce silinebilir.

WdfObjectDereferenceyerine WdfObjectDereferenceActual veyaWdfObjectDereferenceWithTag çağrılması, Microsoft hata ayıklayıcılarına ek bilgiler (etiket dizesi, satır numarası ve dosya adı) sağlar. WdfObjectDereferenceActual sürücünüzün satır numarasını ve dosya adını belirtmesine izin verirken, WdfObjectDereferenceWithTag 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ı azalan ve başvuruya bir etiket değeri atar.

WdfObjectDereferenceWithTag(
                            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.

WdfObjectDereference

WdfObjectReferenceWithTag