Makro WdfObjectDereferenceWithTag
[Berlaku untuk KMDF dan UMDF]
Makro WdfObjectDereferenceWithTag mengurangi jumlah referensi untuk objek kerangka kerja tertentu dan menetapkan nama file dan nomor baris driver saat ini ke referensi. Makro ini juga menetapkan nilai tag ke referensi.
Sintaks
VOID WdfObjectDereferenceWithTag(
[in] WDFOBJECT Handle,
[in] PVOID Tag
);
Parameter
Handel [in]
Handel ke objek kerangka kerja.
Tag [in]
Nilai yang ditentukan driver yang mengidentifikasi referensi objek. Nilai tag harus cocok dengan nilai tag yang sebelumnya disediakan driver ke WdfObjectReferenceWithTag.
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 WdfObjectDereferenceWithTag kembali.
Memanggil WdfObjectDereferenceActual atau WdfObjectDereferenceWithTag alih-alihWdfObjectDereference menyediakan informasi tambahan (string tag, nomor baris, dan nama file) ke debugger Microsoft. WdfObjectDereferenceActual memungkinkan driver Anda menentukan nomor baris dan nama file, sementara WdfObjectDereferenceWithTag menggunakan nomor baris dan nama file driver saat ini.
Anda dapat melihat nilai tag, nomor baris, dan nama file dengan menggunakan ekstensi debugger !wdftagtracker . Ekstensi debugger menampilkan nilai tag sebagai penunjuk dan serangkaian karakter. Untuk informasi selengkapnya tentang ekstensi debugger, lihat Men-debug Driver KMDF.
Untuk informasi selengkapnya tentang jumlah referensi objek, lihat Siklus Hidup Objek Kerangka Kerja.
Contoh
Contoh kode berikut mengurangi jumlah referensi objek dan menetapkan nilai tag ke referensi.
WdfObjectDereferenceWithTag(
object,
pTag
);
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 |
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