EVT_WDF_CHILD_LIST_ADDRESS_DESCRIPTION_CLEANUP回呼函式 (wdfchildlist.h)

發行項
02/29/2024

[僅適用於 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 結構的指標。

傳回值

無

備註

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

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

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

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