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

Artigo
03/01/2024

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

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 do 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.

Retornar valor

Nenhum

Comentários

Quando um driver de filtro aloca uma estrutura de contexto ECP, ele pode, opcionalmente, especificar uma rotina tipada PFSRTL_EXTRA_CREATE_PARAMETER_CLEANUP_CALLBACK como a rotina de retorno de chamada CleanupCallback do driver de filtro. Se o driver de filtro especificar uma rotina de retorno de chamada CleanupCallback , o sistema operacional invocará a rotina CleanupCallback (independentemente do nível do IRQ). Essa rotina CleanupCallback executa qualquer processamento de limpeza relacionado ao contexto ECP necessário quando a estrutura de contexto do 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 NULL deverá ser passado para o parâmetro CleanupCallback .

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

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista
Plataforma de Destino	Área de Trabalho
Cabeçalho	ntifs.h (include Ntifs.h, FltKernel.h)
IRQL	PASSIVE_LEVEL