EVT_WDF_CHILD_LIST_ADDRESS_DESCRIPTION_CLEANUP fungsi panggilan balik (wdfchildlist.h)

Artikel
02/26/2024

[Berlaku untuk KMDF saja]

Fungsi panggilan balik peristiwa EvtChildListAddressDescriptionCleanup driver membebaskan alokasi memori apa pun untuk deskripsi alamat bahwa fungsi panggilan balik EvtChildListAddressDescriptionDuplicate driver dialokasikan.

Sintaks

EVT_WDF_CHILD_LIST_ADDRESS_DESCRIPTION_CLEANUP EvtWdfChildListAddressDescriptionCleanup;

void EvtWdfChildListAddressDescriptionCleanup(
  [in]      WDFCHILDLIST ChildList,
  [in, out] PWDF_CHILD_ADDRESS_DESCRIPTION_HEADER AddressDescription
)
{...}

Parameter

[in] ChildList

Handel ke objek daftar turunan kerangka kerja.

[in, out] AddressDescription

Penunjuk ke struktur WDF_CHILD_ADDRESS_DESCRIPTION_HEADER yang mengidentifikasi deskripsi alamat.

Nilai kembali

Tidak ada

Keterangan

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

Jika deskripsi alamat menunjuk ke informasi tambahan yang disimpan dalam memori yang dialokasikan secara dinamis, dan jika memori tersebut dialokasikan oleh fungsi panggilan balik EvtChildListAddressDescriptionDuplicate , driver harus menyediakan fungsi panggilan balik EvtChildListAddressDescriptionCleanup .

Biasanya, fungsi panggilan balik EvtChildListAddressDescriptionDuplicate mengalokasikan memori dengan memanggil ExAllocatePool. Fungsi panggilan balik EvtChildListAddressDescriptionCleanup harus membatalkan alokasi memori tersebut dengan memanggil ExFreePool. Fungsi panggilan balik ini tidak boleh mencoba membatalkan alokasi deskripsi alamat lainnya. Dengan kata lain, fungsi panggilan balik tidak boleh membatalkan alokasi struktur deskripsi alamat yang ditunjuk oleh parameter AddressDescription ; itu harus membatalkan alokasi hanya alokasi memori tambahan yang ditunjukkan struktur deskripsi.

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