EVT_WDF_CHILD_LIST_IDENTIFICATION_DESCRIPTION_CLEANUP Rückruffunktion (wdfchildlist.h)

Artikel
02/26/2024

[Gilt nur für KMDF]

Die EvtChildListIdentificationDescriptionCleanup-Ereignisrückruffunktion eines Treibers gibt alle Speicherbelegungen für eine Identifikationsbeschreibung frei, die der EvtChildListIdentificationDescriptionDuplicate-Rückruffunktion des Treibers zugeordnet wurde.

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-Objekt mit untergeordneter Liste.

[in, out] IdentificationDescription

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

Rückgabewert

Keine

Bemerkungen

Wenn ein Bustreiber eine dynamische Enumeration verwendet, kann er eine EvtChildListIdentificationDescriptionCleanup-Rückruffunktion registrieren, indem er WdfFdoInitSetDefaultChildListConfig oder WdfChildListCreate aufruft.

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

In der Regel belegt die Rückruffunktion EvtChildListIdentificationDescriptionDuplicate Speicher durch Aufrufen von ExAllocatePool. Die Rückruffunktion EvtChildListIdentificationDescriptionCleanup muss die Zuordnung dieses Speichers aufheben, indem ExFreePool aufgerufen wird. Diese Rückruffunktion darf nicht versuchen, die Zuordnung des Rests der Identifizierungsbeschreibung zu aufheben. Anders ausgedrückt: Die Rückruffunktion darf die Zuordnung der Adressbeschreibungsstruktur, auf die der IdentificationDescription-Parameter verweist, nicht aufheben. Es muss nur die Zuordnung zusätzlicher Speicherbelegungen aufheben, auf die die Beschreibungsstruktur verweist.

Weitere Informationen zur dynamischen Enumeration finden Sie unter Auflisten der Geräte in einem Bus.