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. Defina como sizeof(FLT_RELATED_CONTEXTS_EX).

[in] Contexts

Ponteiro para a estrutura FLT_RELATED_CONTEXTS_EX .

Retornar valor

Nenhum

Comentários

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 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ência de contexto, consulte Referenciando contextos.

Os chamadores de FltReleaseContextsEx devem estar em execução em 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 em IRQL <= APC_LEVEL.

Quando a contagem de referência de cada contexto atinge zero, o contexto é liberado imediatamente se o chamador estiver em execução em 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
Cliente mínimo com suporte Disponível a partir do Windows 8.
Plataforma de Destino Universal
Cabeçalho fltkernel.h (inclua Fltkernel.h)
Biblioteca FltMgr.lib
DLL Fltmgr.sys
IRQL Consulte a seção Observações.

Confira também

FLT_CONTEXT_REGISTRATION

FLT_RELATED_CONTEXTS_EX

FltAllocateContext

FltGetContextsEx

FltReleaseContext