Fungsi WdfObjectReferenceActual (wdfobject.h)

  • Artikel

[Berlaku untuk KMDF dan UMDF]

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

Sintaks

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

Parameter

[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 berupa NULL.

Nilai kembali

Tidak ada

Keterangan

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

Jika driver Anda memanggil WdfObjectReferenceActual untuk menambah jumlah referensi, driver harus memanggil WdfObjectDereferenceActual untuk mengurangi hitungan.

Memanggil WdfObjectReferenceActual atau WdfObjectReferenceWithTag alih-alihWdfObjectReference memberikan 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 Men-debug 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 menambah jumlah referensi objek dan menetapkan nilai tag, nomor baris, dan nama file ke referensi.

WdfObjectReferenceActual(
                         object,
                         pTag,
                         line,
                         FILE_NAME
                         );

Persyaratan

Persyaratan Nilai
Target Platform 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(kmdf)

Lihat juga

WdfObjectReference