Fungsi WdfObjectReferenceActual (wdfobject.h)

[Berlaku untuk KMDF dan UMDF]

Metode WdfObjectReferenceActual menaikkan jumlah referensi untuk objek kerangka kerja tertentu dan menetapkan nilai tag, nomor baris, dan nama file ke referensi.

Sintaksis

VOID WdfObjectReferenceActual(
  [in]           WDFOBJECT Handle,
  [in, optional] PVOID     Tag,
  [in]           LONG      Line,
  [in]           PCCH      File
);

Parameter-parameternya

[in] Handle

Handel ke objek kerangka kerja.

[in, optional] Tag

Nilai yang ditentukan driver yang disimpan kerangka kerja sebagai tag identifikasi untuk referensi objek.

[in] Line

Nilai numerik yang mewakili nomor baris dalam file sumber driver.

[in] File

Penunjuk ke string karakter konstanta yang dihentikan null yang mewakili nama file sumber driver. Parameter ini bersifat opsional dan dapat NULL.

Mengembalikan nilai

Tidak

Komentar

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

Jika driver Anda memanggil WdfObjectReferenceActual untuk menaikkan jumlah referensi, driver harus memanggil WdfObjectDereferenceActual 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.

Untuk informasi selengkapnya tentang aturan pembersihan untuk hierarki objek kerangka kerja, lihat Siklus Hidup Objek Kerangka Kerja.

Contoh

Contoh kode berikut menaikkan jumlah referensi objek dan menetapkan nilai tag, nomor baris, dan nama file ke referensi.

WdfObjectReferenceActual(
                         object,
                         pTag,
                         line,
                         FILE_NAME
                         );

Persyaratan

Persyaratan	Nilai
Platform Target	Universal
versi KMDF Minimum	1.0
versi UMDF Minimum	2.0
Tajuk	wdfobject.h (termasuk Wdf.h)
Perpustakaan	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	<=DISPATCH_LEVEL
aturan kepatuhan DDI	DriverBuat(kmdf)

Lihat juga

WdfObjectReference