EVT_WDF_CHILD_LIST_SCAN_FOR_CHILDREN fungsi panggilan balik (wdfchildlist.h)

Artikel
02/29/2024

[Hanya berlaku untuk KMDF]

Fungsi panggilan balik peristiwa EvtChildListScanForChildren driver harus melaporkan semua perangkat anak yang ada.

Sintaks

EVT_WDF_CHILD_LIST_SCAN_FOR_CHILDREN EvtWdfChildListScanForChildren;

void EvtWdfChildListScanForChildren(
  [in] WDFCHILDLIST ChildList
)
{...}

Parameter

[in] ChildList

Handel ke objek daftar anak kerangka kerja.

Nilai kembali

Tidak ada

Keterangan

Jika driver bus menggunakan enumerasi dinamis, driver dapat mendaftarkan fungsi panggilan balik EvtChildListScanForChildren dengan memanggil WdfFdoInitSetDefaultChildListConfig atau WdfChildListCreate.

Jika driver menyediakan fungsi panggilan balik EvtChildListScanForChildren , kerangka kerja memanggilnya setiap kali perangkat induk memasuki status berfungsi (D0). (Untuk informasi selengkapnya tentang kapan fungsi panggilan balik ini dipanggil, lihat Skenario PnP dan Manajemen Daya.)

Driver harus melaporkan semua perangkat turunannya dengan melakukan hal berikut:

Memanggil WdfChildListBeginScan, yang menandai semua perangkat anak yang dilaporkan sebelumnya sebagai hilang.
Mendeteksi perangkat anak dan memanggil WdfChildListAddOrUpdateChildDescriptionAsPresent untuk setiap perangkat yang terdeteksi.
Memanggil WdfChildListEndScan, yang memberi tahu manajer PnP tentang perangkat anak yang dilaporkan.

Untuk informasi selengkapnya tentang enumerasi dinamis, lihat Menghitung Perangkat di Bus.

Fungsi panggilan balik EvtChildListScanForChildren dipanggil di IRQL = PASSIVE_LEVEL. Anda tidak boleh membuat fungsi panggilan balik ini dapat di-pageable.