Makro WdfObjectReferenceWithTag

[Berlaku untuk KMDF dan UMDF]

Makro WdfObjectReferenceWithTag menaikkan jumlah referensi untuk objek kerangka kerja tertentu dan menetapkan nama file dan nomor baris driver saat ini ke referensi. Makro juga menetapkan nilai tag ke referensi.

Sintaksis

VOID WdfObjectReferenceWithTag(
  [in] WDFOBJECT Handle,
  [in] PVOID     Tag
);

Parameter-parameternya

Menangani [in]
Handel ke objek kerangka kerja.

Tag [in]
Nilai yang ditentukan driver yang disimpan kerangka kerja sebagai tag identifikasi untuk referensi objek.

Mengembalikan nilai

Tidak ada.

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

Komentar

Jika driver Anda memanggil WdfObjectReferenceWithTag untuk menaikkan jumlah referensi, driver harus memanggil WdfObjectDereferenceWithTag untuk mengurangi jumlah.

Memanggil WdfObjectReferenceActual atau WdfObjectReferenceWithTag alih-alih WdfObjectReference menyediakan informasi tambahan (nilai tag, nomor baris, dan nama file) ke debugger Microsoft. WdfObjectReferenceActual memungkinkan driver Anda menentukan nomor baris dan nama file, sementara WdfObjectReferenceWithTag 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 Debugging Driver KMDF.

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

Contoh

Contoh kode berikut menaikkan jumlah referensi objek dan menetapkan nilai tag ke referensi.

WdfObjectReferenceWithTag(
                          object,
                          pTag
                          );

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

Lihat juga

WdfObjectReference