EVT_WDF_CHILD_LIST_IDENTIFICATION_DESCRIPTION_CLEANUP Rückruffunktion (wdfchildlist.h)

Artikel
02/07/2025

[Gilt nur für KMDF]

Die EvtChildListIdentificationDescriptionCleanup Ereignisrückruffunktion gibt speicherzuordnungen für eine Identifikationsbeschreibung frei, die der Treiber EvtChildListIdentificationDescriptionDuplicate zugewiesenen Rückruffunktion freigibt.

Syntax

EVT_WDF_CHILD_LIST_IDENTIFICATION_DESCRIPTION_CLEANUP EvtWdfChildListIdentificationDescriptionCleanup;

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

Parameter

[in] ChildList

Ein Handle für ein framework untergeordnetes Listenobjekt.

[in, out] IdentificationDescription

Ein Zeiger auf eine WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER Struktur, die eine Identifikationsbeschreibung identifiziert.

Rückgabewert

Nichts

Bemerkungen

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

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

In der Regel weist die EvtChildListIdentificationDescriptionDuplicate Rückruffunktion Speicher zu, indem ExAllocatePoolaufgerufen wird. Die EvtChildListIdentificationDescriptionCleanup Rückruffunktion muss diesen Speicher durch Aufrufen ExFreePool-behandeln. Diese Rückruffunktion darf nicht versuchen, die restliche Identifikationsbeschreibung zuzuweisen. Mit anderen Worten: Die Rückruffunktion darf die Adressbeschreibungsstruktur, auf die die IdentificationDescription Parameter verweist, nicht umstellen; 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-.