Fungsi WdfChildListBeginIteration (wdfchildlist.h)
[Berlaku untuk KMDF saja]
Metode WdfChildListBeginIteration menyiapkan kerangka kerja untuk mengambil item dari daftar anak tertentu.
Sintaks
void WdfChildListBeginIteration(
[in] WDFCHILDLIST ChildList,
[in] PWDF_CHILD_LIST_ITERATOR Iterator
);
Parameter
[in] ChildList
Handel ke objek daftar anak kerangka kerja.
[in] Iterator
Penunjuk ke struktur WDF_CHILD_LIST_ITERATOR yang dialokasikan penelepon yang menunjukkan jenis perangkat anak yang akan diambil.
Nilai kembali
Tidak ada
Keterangan
Pemeriksaan bug terjadi jika driver menyediakan handel objek yang tidak valid.
Setelah memanggil WdfChildListBeginIteration, driver dapat berulang kali memanggil WdfChildListRetrieveNextDevice untuk mendapatkan informasi tentang setiap perangkat anak dalam daftar anak.
Setelah driver selesai memanggil WdfChildListRetrieveNextDevice, driver harus memanggil WdfChildListEndIteration.
Jika driver membuat perubahan pada daftar anak setelah memanggil WdfChildListBeginIteration, kerangka kerja menyimpan semua perubahan dan memberi tahu manajer Plug and Play (PnP) tentang perubahan saat driver memanggil WdfChildListEndIteration.
Driver dapat menumpuk panggilan ke WdfChildListBeginIteration dan WdfChildListEndIteration. Jika driver menumpuk panggilan ke metode ini, kerangka kerja menyimpan semua perubahan hingga panggilan terakhir ke WdfChildListEndIteration.
Untuk informasi selengkapnya tentang daftar anak, lihat Enumerasi Dinamis.
Contoh
Untuk contoh kode yang menggunakan WdfChildListBeginIteration, lihat WdfChildListRetrieveNextDevice.
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