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

WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER_INIT

WDF_CHILD_LIST_ITERATOR

WDF_CHILD_LIST_ITERATOR_INIT

WdfChildListBeginScan

WdfChildListEndIteration

WdfChildListRequestChildEject

WdfChildListRetrieveNextDevice