Função FltGetInstanceContext (fltkernel.h)

A rotina FltGetInstanceContext recupera um contexto que foi definido para uma instância por um determinado driver de minifiltro.

Sintaxe

NTSTATUS FLTAPI FltGetInstanceContext(
  [in]  PFLT_INSTANCE Instance,
  [out] PFLT_CONTEXT  *Context
);

Parâmetros

[in] Instance

Ponteiro de instância opaca para a instância.

[out] Context

Ponteiro para uma variável alocada por chamador que recebe o endereço do contexto da instância.

Valor retornado

FltGetInstanceContext retorna STATUS_SUCCESS ou um valor NTSTATUS apropriado, como o seguinte:

Código de retorno Descrição
STATUS_NOT_FOUND Nenhum contexto correspondente foi encontrado. Este é um código de erro.

Comentários

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

FltGetInstanceContext recupera um contexto que foi definido para uma instância por um determinado driver de minifiltro.

FltGetInstanceContext incrementa a contagem de referência no contexto ao qual o parâmetro Context aponta. Quando esse ponteiro de contexto não é mais necessário, o chamador deve diminuir sua contagem de referência chamando FltReleaseContext. Portanto, cada chamada bem-sucedida para FltGetInstanceContext deve ser correspondida por uma chamada subsequente a FltReleaseContext.

Para definir um contexto para uma instância, chame FltSetInstanceContext.

Para alocar um novo contexto, chame FltAllocateContext.

Para excluir um contexto de arquivo, chame FltDeleteInstanceContext ou FltDeleteContext.

Requisitos

   
Plataforma de Destino Universal
Cabeçalho fltkernel.h (include Fltkernel.h)
Biblioteca FltMgr.lib
DLL Fltmgr.sys
IRQL <= APC_LEVEL

Confira também

FltAllocateContext

FltDeleteContext

FltDeleteInstanceContext

FltReleaseContext

FltSetInstanceContext