Makro WdfObjectReference

[Berlaku untuk KMDF dan UMDF]

Makro WdfObjectReference menaikkan jumlah referensi untuk objek kerangka kerja tertentu.

Sintaks

VOID WdfObjectReference(
  [in] WDFOBJECT Handle
);

Parameter

Handel [in]
Handel ke objek kerangka kerja.

Menampilkan nilai

Tidak ada.

Pemeriksaan bug terjadi jika driver menyediakan handel objek yang tidak valid.

Keterangan

Jika driver Anda memanggil WdfObjectReference untuk menaikkan jumlah referensi, driver harus memanggil WdfObjectDereference untuk mengurangi jumlah.

Alih-alih memanggil WdfObjectReference, driver dapat memanggil WdfObjectReferenceWithTag atau WdfObjectReferenceActual.

Untuk informasi selengkapnya tentang jumlah referensi objek, lihat Siklus Hidup Objek Kerangka Kerja.

Contoh

Contoh kode berikut menaikkan jumlah referensi objek.

WdfObjectReference(Object); 

Persyaratan

Platform target	Universal
Versi KMDF minimum	1,0
Versi UMDF minimum	2.0
Header	Wdfobject.h (termasuk Wdf.h)
Pustaka	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	<= DISPATCH_LEVEL
Aturan kepatuhan DDI	DriverCreate, MemAfterReqCompletedIntIoctlA, MemAfterReqCompletedIoctlA, MemAfterReqCompletedReadA, MemAfterReqCompletedWriteA

Lihat juga

WdfObjectReferenceActual

WdfObjectReferenceWithTag