共用方式為


EVT_WDF_CHILD_LIST_ADDRESS_DESCRIPTION_CLEANUP回呼函式 (wdfchildlist.h)

[僅適用於 KMDF]

驅動程式的 EvtChildListAddressDescriptionCleanup 事件回呼函式會釋放驅動程式 EvtChildListAddressDescriptionDuplicate 回呼函式配置的任何記憶體配置。

語法

EVT_WDF_CHILD_LIST_ADDRESS_DESCRIPTION_CLEANUP EvtWdfChildListAddressDescriptionCleanup;

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

參數

[in] ChildList

架構子清單物件的句柄。

[in, out] AddressDescription

識別位址描述 之WDF_CHILD_ADDRESS_DESCRIPTION_HEADER 結構的指標。

傳回值

備註

如果總線驅動程式使用動態列舉,它可以呼叫 WdfFdoInitSetDefaultChildListConfigWdfChildListCreate 來註冊 EvtChildListAddressDescriptionCleanup 回呼函式。

如果位址描述指向儲存在動態配置記憶體中的其他資訊,而且該記憶體是由 EvtChildListAddressDescriptionDuplicate 回呼函式所配置,驅動程式必須提供 EvtChildListAddressDescriptionCleanup 回呼函式。

一般而言, EvtChildListAddressDescriptionDuplicate 回呼函式會呼叫 ExAllocatePool 來配置記憶體。 EvtChildListAddressDescriptionCleanup 回呼函式必須藉由呼叫 ExFreePool 解除分配該記憶體。 此回呼函式不得嘗試解除分配位址描述的其餘部分。 換句話說,回呼函式不得解除分配 AddressDescription 參數指向的位址描述結構;它必須只解除分配描述結構指向的其他記憶體配置。

如需動態列舉的詳細資訊,請參閱 列舉總線上的裝置

規格需求

需求
目標平台 Universal
最小 KMDF 版本 1.0
標頭 wdfchildlist.h (包含 Wdf.h)
IRQL <= DISPATCH_LEVEL

另請參閱

EvtChildListAddressDescriptionDuplicate

ExAllocatePool

ExFreePool

WDF_CHILD_ADDRESS_DESCRIPTION_HEADER

WdfChildListCreate

WdfFdoInitSetDefaultChildListConfig