Fungsi WdfChildListBeginScan (wdfchildlist.h)
[Hanya berlaku untuk KMDF]
Metode WdfChildListBeginScan menyiapkan daftar perangkat anak tertentu sehingga driver dapat memperbarui informasi dalam daftar.
Sintaks
void WdfChildListBeginScan(
[in] WDFCHILDLIST ChildList
);
Parameter
[in] ChildList
Handel ke objek daftar anak kerangka kerja.
Nilai kembali
Tidak ada
Keterangan
Pemeriksaan bug terjadi jika driver menyediakan handel objek yang tidak valid.
Metode WdfChildListBeginScan menandai semua perangkat anak dalam daftar sebagai hilang.
Setelah memanggil WdfChildListBeginScan, driver dapat memanggil WdfChildListAddOrUpdateChildDescriptionAsPresent berulang kali, atau memanggil WdfChildListUpdateAllChildDescriptionsAsPresent, untuk melaporkan semua perangkat anak yang saat ini dilampirkan ke perangkat induk.
Setelah driver selesai memperbarui daftar anak, driver harus memanggil WdfChildListEndScan. Panggilan ini mengirimkan daftar anak yang diperbarui ke manajer Plug and Play (PnP). Selanjutnya, kerangka kerja akan memanggil fungsi panggilan balik EvtChildListCreateDevice driver untuk setiap perangkat yang dilaporkan driver.
Untuk informasi selengkapnya tentang daftar anak, lihat Enumerasi Dinamis.
Contoh
Untuk contoh kode yang menggunakan WdfChildListBeginScan, lihat WdfChildListAddOrUpdateChildDescriptionAsPresent.
Persyaratan
Persyaratan | Nilai |
---|---|
Target Platform | Universal |
Versi KMDF minimum | 1,0 |
Header | wdfchildlist.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