Aracılığıyla paylaş


WdfObjectReference makrosu

[KMDF ve UMDF için geçerlidir]

WdfObjectReference makrosu, belirtilen bir çerçeve nesnesi için başvuru sayısını artırır.

Sözdizimi

VOID WdfObjectReference(
  [in] WDFOBJECT Handle
);

Parametreler

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

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 WdfObjectReference çağırırsa, sayıyı azaltması için WdfObjectDereferenceçağırmalıdır.

WdfObjectReferenceçağırmak yerine, bir sürücü WdfObjectReferenceWithTag veya WdfObjectReferenceActualçağırabilir.

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.

WdfObjectReference(Object); 

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İ

DDI uyumluluk kuralları

DriverCreate, MemAfterReqCompletedIntIoctlA, MemAfterReqCompletedIoctlA, MemAfterReqCompletedReadA, MemAfterReqCompletedWriteA

Ayrıca bkz.

WdfObjectReferenceActual

WdfObjectReferenceWithTag