Makro WdfObjectDereference
[Berlaku untuk KMDF dan UMDF]
Makro WdfObjectDereference mengurangi jumlah referensi untuk objek kerangka kerja tertentu.
Sintaks
VOID WdfObjectDereference(
[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 jumlah referensi objek menjadi nol, objek mungkin dihapus sebelum WdfObjectDereference kembali.
Driver dapat memanggil WdfObjectDereference hanya jika sebelumnya disebut 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 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, wdfioqueuefindrequestfailed, wdfioqueueretrievefoundrequest |
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk