Função FltGetInstanceContext (fltkernel.h)

Artigo
02/29/2024

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 opaco para a instância.

[out] Context

Ponteiro para uma variável alocada pelo chamador que recebe o endereço do contexto da instância. Esse parâmetro é necessário e não pode ser definido como NULL.

Retornar valor

FltGetInstanceContext retorna STATUS_SUCCESS quando retorna com êxito o contexto da instância solicitada. Caso contrário, ele retornará um valor NTSTATUS apropriado, como o seguinte:

Código de retorno	Descrição
STATUS_NOT_FOUND	Nenhum contexto correspondente foi encontrado nesta instância no momento. FltMgr define Contexto como NULL_CONTEXT. 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 para o qual o parâmetro Context aponta. Quando esse ponteiro de contexto não for mais necessário, o chamador deverá diminuir sua contagem de referência chamando FltReleaseContext. Portanto, cada chamada bem-sucedida para FltGetInstanceContext deve ser correspondida por uma chamada subsequente para 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.