PFSRTL_EXTRA_CREATE_PARAMETER_CLEANUP_CALLBACK função de retorno de chamada (ntifs.h)

Artigo
12/21/2024

Um driver de filtro pode registrar uma rotina tipo PFSRTL_EXTRA_CREATE_PARAMETER_CLEANUP_CALLBACK como CleanupCallback do driver de filtro rotina de retorno de chamada para uma estrutura de contexto ECP (parâmetro de criação extra).

Sintaxe

PFSRTL_EXTRA_CREATE_PARAMETER_CLEANUP_CALLBACK PfsrtlExtraCreateParameterCleanupCallback;

void PfsrtlExtraCreateParameterCleanupCallback(
  [in, out] PVOID EcpContext,
  [in[]     LPCGUID EcpType
)
{...}

Parâmetros

[in, out] EcpContext

Um ponteiro de contexto ECP que foi retornado pela rotina que alocou a estrutura de contexto ECP.

[in[] EcpType

Um ponteiro para um GUID que foi passado para a rotina que alocou a estrutura de contexto ECP, que indica o tipo de parâmetro de criação extra. Para obter mais informações, consulte Usando GUIDs em drivers.

Valor de retorno

Nenhum

Observações

Quando um driver de filtro aloca uma estrutura de contexto ECP, ele pode, opcionalmente, especificar uma rotina tipo PFSRTL_EXTRA_CREATE_PARAMETER_CLEANUP_CALLBACK como CleanupCallback do driver de filtro rotina de retorno de chamada. Se o driver de filtro especificar uma rotina de CleanupCallback retorno de chamada, o sistema operacional invocará a rotina de CleanupCallback (independentemente do nível do IRQ). Essa rotina CleanupCallback executa qualquer processamento de limpeza necessário relacionado ao contexto ECP quando a estrutura de contexto ECP é excluída.

Para especificar uma rotina de retorno de chamada, um driver de filtro passa um ponteiro para a rotina de retorno de chamada usando o parâmetro CleanupCallback da rotina que originalmente alocava a estrutura de contexto ECP. Se uma rotina de retorno de chamada não for necessária, um valor de NULL deverá ser passado para o parâmetro CleanupCallback .

As seguintes rotinas dão suporte à rotina de retorno de chamada tipo PFSRTL_EXTRA_CREATE_PARAMETER_CLEANUP_CALLBACK:

FltAllocateExtraCreateParameter
FltAllocateExtraCreateParameterFromLookasideList
FsRtlAllocateExtraCreateParameter

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows Vista
da Plataforma de Destino	Área de trabalho
cabeçalho	ntifs.h (inclua Ntifs.h, FltKernel.h)
IRQL	PASSIVE_LEVEL

Consulte também

ECP_LIST

FltAllocateExtraCreateParameter

FltAllocateExtraCreateParameterFromLookasideList

FltAllocateExtraCreateParameterList

FltFreeExtraCreateParameter

FltFreeExtraCreateParameterList

FltRemoveExtraCreateParameter

Partilhar via