EVT_WDF_CHILD_LIST_IDENTIFICATION_DESCRIPTION_CLEANUP função de retorno de chamada (wdfchildlist.h)
[Aplica-se somente ao KMDF]
A função de retorno de chamada de evento EvtChildListIdentificationDescriptionCleanup do driver libera todas as alocações de memória para uma descrição de identificação que a função de retorno de chamada EvtChildListIdentificationDescriptionDuplicate do driver alocada.
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.
Valor de retorno
Nenhum
Observações
Se um motorista de ônibus estiver usando de 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 um EvtChildListIdentificationDescriptionDuplicate função de retorno de chamada, o driver deverá fornecer um EvtChildListIdentificationDescriptionCleanup função de retorno de chamada.
Normalmente, a função 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 à 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.
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Universal |
| versão mínima do KMDF | 1.0 |
| cabeçalho | wdfchildlist.h (inclua Wdf.h) |
| IRQL | <= DISPATCH_LEVEL |
Consulte também
EvtChildListIdentificationDescriptionDuplicate