Fungsi WdfDeviceAddRemovalRelationsPhysicalDevice (wdfdevice.h)
[Berlaku untuk KMDF saja]
Metode WdfDeviceAddRemovalRelationsPhysicalDevice menunjukkan bahwa perangkat tertentu harus dihapus ketika perangkat lain yang ditentukan dihapus.
Sintaks
NTSTATUS WdfDeviceAddRemovalRelationsPhysicalDevice(
[in] WDFDEVICE Device,
[in] PDEVICE_OBJECT PhysicalDevice
);
Parameter
[in] Device
Handel ke objek perangkat kerangka kerja.
[in] PhysicalDevice
Penunjuk ke struktur DEVICE_OBJECT yang disediakan penelepon yang mewakili objek perangkat fisik (PDO).
Nilai kembali
Jika operasi berhasil, WdfDeviceAddRemovalRelationsPhysicalDevice mengembalikan STATUS_SUCCESS. Nilai pengembalian tambahan meliputi:
Menampilkan kode | Deskripsi |
---|---|
|
PhysicalDevice adalah NULL. |
|
Alokasi memori gagal. |
Metode ini mungkin mengembalikan nilai NTSTATUS lainnya.
Pemeriksaan bug terjadi jika driver menyediakan handel objek yang tidak valid.
Keterangan
Parameter PhysicalDevice menunjuk ke PDO perangkat yang drivernya harus dihapus saat driver untuk Perangkat dihapus. Biasanya, kedua perangkat dikendalikan oleh driver panggilan. Jangan melaporkan perangkat anak dari objek perangkat yang ditentukan di Perangkat karena ketika manajer Plug and Play menghapus perangkat induk, perangkat juga akan menghapus turunan perangkat.
Driver Anda dapat memanggil WdfDeviceAddRemovalRelationsPhysicalDevice beberapa kali untuk menambahkan beberapa perangkat ke daftar perangkat yang harus dihapus saat Perangkat dihapus. Urutan penghapusan perangkat yang ditentukan tidak ditentukan.
Contoh
Contoh kode berikut menambahkan perangkat yang diidentifikasi pPdo ke daftar perangkat yang harus dihapus saat perangkat yang ditentukan perangkat dihapus.
status = WdfDeviceAddRemovalRelationsPhysicalDevice(
device,
pPdo
);
Persyaratan
Persyaratan | Nilai |
---|---|
Target Platform | Universal |
Versi KMDF minimum | 1,0 |
Header | wdfdevice.h (termasuk Wdf.h) |
Pustaka | Wdf01000.sys (lihat Penerapan Versi Pustaka Kerangka Kerja.) |
IRQL | <= DISPATCH_LEVEL |
Aturan kepatuhan DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |
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