EVT_WDF_CHILD_LIST_ADDRESS_DESCRIPTION_CLEANUP Rückruffunktion (wdfchildlist.h)

Artikel
02/07/2025

[Gilt nur für KMDF]

Die EvtChildListAddressDescriptionCleanup Ereignisrückruffunktion gibt speicherzuweisungen für eine Adressbeschreibung frei,, dass dem Treiber EvtChildListAddressDescriptionDuplicate Rückruffunktion zugewiesen wurde.

Syntax

EVT_WDF_CHILD_LIST_ADDRESS_DESCRIPTION_CLEANUP EvtWdfChildListAddressDescriptionCleanup;

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

Parameter

[in] ChildList

Ein Handle für ein framework untergeordnetes Listenobjekt.

[in, out] AddressDescription

Ein Zeiger auf eine WDF_CHILD_ADDRESS_DESCRIPTION_HEADER Struktur, die eine Adressbeschreibung identifiziert.

Rückgabewert

Nichts

Bemerkungen

Wenn ein Bustreiber dynamische Enumerationverwendet, kann er eine EvtChildListAddressDescriptionCleanup Rückruffunktion registrieren, indem WdfFdoInitSetDefaultChildListConfig oder WdfChildListCreateaufgerufen wird.

Wenn eine Adressbeschreibung auf zusätzliche Informationen verweist, die im dynamisch zugeordneten Speicher gespeichert sind und dieser Speicher von einer EvtChildListAddressDescriptionDuplicate Rückruffunktion zugewiesen wird, muss der Treiber eine EvtChildListAddressDescriptionCleanup Rückruffunktion bereitstellen.

In der Regel weist die EvtChildListAddressDescriptionDuplicate Rückruffunktion Arbeitsspeicher zu, indem ExAllocatePoolaufgerufen wird. Die EvtChildListAddressDescriptionCleanup Rückruffunktion muss diesen Speicher durch Aufrufen ExFreePool-behandeln. Diese Rückruffunktion darf nicht versuchen, die restliche Adressbeschreibung zuzuweisen. Mit anderen Worten, die Rückruffunktion darf die Adressbeschreibungsstruktur nicht behandeln, auf die die AddressDescription Parameter verweist; sie muss nur zusätzliche Speicherzuweisungen behandeln, auf die die Beschreibungsstruktur verweist.

Weitere Informationen zur dynamischen Aufzählung finden Sie unter Aufzählen der Geräte auf einem Bus-.