EVT_WDF_CHILD_LIST_IDENTIFICATION_DESCRIPTION_CLEANUP fungsi panggilan balik (wdfchildlist.h)

Artikel
02/29/2024

[Berlaku untuk KMDF saja]

Fungsi panggilan balik peristiwa EvtChildListIdentificationDescriptionCleanup driver membebaskan alokasi memori apa pun untuk deskripsi identifikasi bahwa fungsi panggilan balik EvtChildListIdentificationDescriptionDuplicate driver dialokasikan.

Sintaks

EVT_WDF_CHILD_LIST_IDENTIFICATION_DESCRIPTION_CLEANUP EvtWdfChildListIdentificationDescriptionCleanup;

void EvtWdfChildListIdentificationDescriptionCleanup(
  [in]      WDFCHILDLIST ChildList,
  [in, out] PWDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER IdentificationDescription
)
{...}

Parameter

[in] ChildList

Handel ke objek daftar turunan kerangka kerja.

[in, out] IdentificationDescription

Penunjuk ke struktur WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER yang mengidentifikasi deskripsi identifikasi.

Nilai kembali

Tidak ada

Keterangan

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

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

Biasanya, fungsi panggilan balik EvtChildListIdentificationDescriptionDuplicate mengalokasikan memori dengan memanggil ExAllocatePool. Fungsi panggilan balik EvtChildListIdentificationDescriptionCleanup harus membatalkan alokasi memori tersebut dengan memanggil ExFreePool. Fungsi panggilan balik ini tidak boleh mencoba membatalkan alokasi deskripsi identifikasi lainnya. Dengan kata lain, fungsi panggilan balik tidak boleh membatalkan struktur deskripsi alamat yang ditunjukkan parameter IdentificationDescription ; itu harus membatalkan alokasi hanya alokasi memori tambahan yang ditunjukkan struktur deskripsi.

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