Makro WdfObjectDereference

[Berlaku untuk KMDF dan UMDF]

Makro WdfObjectDereference mengurangi jumlah referensi untuk objek kerangka kerja tertentu.

Sintaksis

VOID WdfObjectDereference(
  [in] WDFOBJECT Handle
);

Parameter-parameternya

Menangani [in]
Handel ke objek kerangka kerja.

Mengembalikan nilai

Tidak ada.

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

Komentar

Jika jumlah referensi objek menjadi nol, objek mungkin dihapus sebelum WdfObjectDereference kembali.

Driver dapat memanggil WdfObjectDereference hanya jika sebelumnya telah memanggil WdfObjectReference.

Alih-alih memanggil WdfObjectDereference, driver dapat memanggil WdfObjectDereferenceWithTag atau WdfObjectDereferenceActual.

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

Contoh

Contoh kode berikut mengurangi jumlah referensi objek.

WdfObjectDereference(Object); 

Persyaratan

Platform sasaran	Universal
Versi KMDF minimum	1.0
Versi UMDF minimum	2.0
Penanda kepala	Wdfobject.h (termasuk Wdf.h)
Perpustakaan	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	<= DISPATCH_LEVEL
Aturan kepatuhan DDI	Driver Buat, MemAfterReqCompletedIntIoctlA, MemAfterReqCompletedIoctlA, MemAfterReqCompletedReadA, MemAfterReqCompletedWriteA, wdfioqueuefindrequestfailed, wdfioqueueretrievefoundrequest

Lihat juga

WdfObjectDereferenceActual

WdfObjectDereferenceWithTag

WdfObjectReference