Aturan TargetRelationNeedsRef (wdm)

Aturan TargetRelationNeedsRef menentukan bahwa saat memproses kueri TargetDeviceRelation , rutin DispatchPnP driver memanggil salah satu fungsi berikut untuk mereferensikan PDO perangkat anak:

• ObReferenceObject

• ObReferenceObjectByHandle

• ObReferenceObjectByPointer

Aturan ini hanya berlaku ketika driver menyelesaikan IRP dengan mengatur Irp->IoStatus.Information penunjuk ke nilai baru non-NULL . Ini tidak diterapkan ketika driver melewati IRP ke driver yang lebih rendah.

Aturan ini tidak menentukan apa yang memenuhi syarat sebagai nilai yang valid untuk Irp->IoStatus.Information. Aturan ini hanya berlaku ketika driver mengubah nilai dan nilai baru bukan NULL. Nilai yang valid adalah penunjuk ke struktur DEVICE_RELATIONS yang berisi informasi relasi yang diminta.

Aturan ini hanya berlaku untuk pengemudi bus.

Model driver: WDM

Cara menguji

Pada waktu kompilasi
Jalankan Pemverifikasi Driver Statis dan tentukan aturan TargetRelationNeedsRef . Gunakan langkah-langkah berikut untuk menjalankan analisis kode Anda: Siapkan kode Anda (gunakan deklarasi jenis peran). Jalankan Pemverifikasi Driver Statis. Lihat dan analisis hasilnya. Untuk informasi selengkapnya, lihat Menggunakan Pemverifikasi Driver Statis untuk Menemukan Cacat pada Driver.

Berlaku untuk

IoCallDriverObReferenceObjectByHandleObReferenceObjectByPointerPoCallDriver

Lihat juga

DanglingDeviceObjectReference