Compartilhar via


Função FltReleaseContextsEx (fltkernel.h)

FltReleaseContextsEx libera cada contexto em uma determinada estrutura FLT_RELATED_CONTEXTS_EX.

Sintaxe

VOID FLTAPI FltReleaseContextsEx(
  [in] SIZE_T                   ContextsSize,
  [in] PFLT_RELATED_CONTEXTS_EX Contexts
);

Parâmetros

[in] ContextsSize

O tamanho, em bytes, da estrutura de FLT_RELATED_CONTEXTS_EX apontada por Contextos. Definido como tamanhos de(FLT_RELATED_CONTEXTS_EX).

[in] Contexts

Ponteiro para a estrutura FLT_RELATED_CONTEXTS_EX.

Valor de retorno

Nenhum

Observações

Para obter mais informações sobre contextos, consulte Sobre contextos de minifiltro.

FltReleaseContextsEx diminui a contagem de referência em todos os contextos na estrutura FLT_RELATED_CONTEXTS_EX e define todos os membros da estrutura como NULL_CONTEXT.

Para obter a estrutura de FLT_RELATED_CONTEXTS_EX para um determinado driver de minifiltro para uma determinada solicitação de E/S, chame FltGetContextsEx .

Para obter mais informações sobre a contagem de referências de contexto, consulte contextos de referência.

Os chamadores de FltReleaseContextsEx devem estar em execução no IRQL <= DISPATCH_LEVEL se todos os contextos foram alocados do pool nãopagado. Se algum contexto tiver sido alocado do pool de páginas, os chamadores deverão estar em execução no IRQL <= APC_LEVEL.

Quando a contagem de referência de cada contexto atingir zero, o contexto será liberado imediatamente se o chamador estiver em execução no IRQL <= APC_LEVEL. Se o chamador estiver em execução no IRQL DISPATCH_LEVEL, um item de trabalho será agendado para liberar o contexto.

Requisitos

Requisito Valor
de cliente com suporte mínimo Disponível a partir do Windows 8.
da Plataforma de Destino Universal
cabeçalho fltkernel.h (inclua Fltkernel.h)
biblioteca FltMgr.lib
de DLL Fltmgr.sys
IRQL Consulte a seção Comentários.

Consulte também

FLT_CONTEXT_REGISTRATION

FLT_RELATED_CONTEXTS_EX

FltAllocateContext

FltGetContextsEx

FltReleaseContext