EVT_WDF_CHILD_LIST_IDENTIFICATION_DESCRIPTION_CLEANUP função de retorno de chamada (wdfchildlist.h)

Artigo
08/08/2023

[Aplica-se somente ao KMDF]

A função de retorno de chamada de evento EvtChildListIdentificationDescriptionCleanup de um driver libera todas as alocações de memória para uma descrição de identificação alocada pela função de retorno de chamada EvtChildListIdentificationDescriptionDuplicate do driver.

Sintaxe

EVT_WDF_CHILD_LIST_IDENTIFICATION_DESCRIPTION_CLEANUP EvtWdfChildListIdentificationDescriptionCleanup;

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

Parâmetros

[in] ChildList

Um identificador para um objeto de lista filho da estrutura.

[in, out] IdentificationDescription

Um ponteiro para uma estrutura WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER que identifica uma descrição de identificação.

Retornar valor

Nenhum

Comentários

Se um driver de barramento estiver usando enumeração dinâmica, ele poderá registrar uma função de retorno de chamada EvtChildListIdentificationDescriptionCleanup chamando WdfFdoInitSetDefaultChildListConfig ou WdfChildListCreate.

Se uma descrição de identificação apontar para informações adicionais armazenadas na memória alocada dinamicamente e se essa memória for alocada por uma função de retorno de chamada EvtChildListIdentificationDescriptionDuplicate , o driver deverá fornecer uma função de retorno de chamada EvtChildListIdentificationDescriptionCleanup .

Normalmente, a função de retorno de chamada EvtChildListIdentificationDescriptionDuplicate aloca memória chamando ExAllocatePool. A função de retorno de chamada EvtChildListIdentificationDescriptionCleanup deve desalocar essa memória chamando ExFreePool. Essa função de retorno de chamada não deve tentar desalocar o restante da descrição de identificação. Em outras palavras, a função de retorno de chamada não deve desalocar a estrutura de descrição do endereço para a qual o parâmetro IdentificationDescription aponta; ele deve desalocar apenas alocações de memória adicionais para as quais a estrutura de descrição aponta.

Para obter mais informações sobre enumeração dinâmica, consulte Enumerando os dispositivos em um barramento.