EVT_WDF_CHILD_LIST_IDENTIFICATION_DESCRIPTION_CLEANUP回呼函式 (wdfchildlist.h)

發行項
02/29/2024

[僅適用於 KMDF]

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

語法

EVT_WDF_CHILD_LIST_IDENTIFICATION_DESCRIPTION_CLEANUP EvtWdfChildListIdentificationDescriptionCleanup;

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

參數

[in] ChildList

架構子清單物件的句柄。

[in, out] IdentificationDescription

識別識別描述之WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER 結構的指標。

傳回值

無

備註

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

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

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

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