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

WdfChildListAddOrUpdateChildDescriptionAsPresent

WdfChildListBeginIteration

WdfChildListEndScan

WdfChildListUpdateAllChildDescriptionsAsPresent