Função FltGetSectionContext (fltkernel.h)

A rotina FltGetSectionContext recupera um contexto de seção que foi criado para um fluxo de arquivos por uma instância de driver de minifiltro especificada.

Sintaxe

NTSTATUS FLTAPI FltGetSectionContext(
  [in]  PFLT_INSTANCE Instance,
  [in]  PFILE_OBJECT  FileObject,
  [out] PFLT_CONTEXT  *Context
);

Parâmetros

[in] Instance

Um ponteiro de instância opaco para a instância do driver de minifiltro cujo contexto deve ser recuperado.

[in] FileObject

Um ponteiro para um objeto de arquivo para o fluxo.

[out] Context

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

Retornar valor

FltGetSectionContext retorna STATUS_SUCCESS quando retorna com êxito o contexto de seção solicitado. Caso contrário, ele retornará um valor NTSTATUS apropriado, como um dos seguintes:

Código de retorno	Descrição
STATUS_NOT_FOUND	Nenhum contexto correspondente foi encontrado neste arquivo no momento, portanto, o FltMgr definiu Context como NULL_CONTEXT. Este é um código de erro.
STATUS_NOT_SUPPORTED	O volume anexado a essa instância não dá suporte a contextos de seção. Este é um código de erro.

Comentários

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

FltGetSectionContext recupera um contexto de seção que foi criado para um fluxo de arquivos por uma instância de driver de minifiltro especificada. Um contexto de seção é criado chamando FltCreateSectionForDataScan.

FltGetSectionContext incrementa a contagem de referência no contexto para o 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 FltGetSectionContext deve ser correspondida por uma chamada subsequente para FltReleaseContext.

Para alocar um novo contexto, chame FltAllocateContext.

Os minifiltros não devem excluir explicitamente um contexto de seção passado para FltCreateSectionForDataScan. Um contexto de seção é desalocado e removido de um fluxo chamando FltCloseSectionForDataScan nesse caso.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 8
Plataforma de Destino	Universal
Cabeçalho	fltkernel.h (inclua Fltkernel.h)
Biblioteca	FltMgr.lib
DLL	Fltmgr.sys
IRQL	<= APC_LEVEL

Confira também

FltAllocateContext

FltCloseSectionForDataScan

FltCreateSectionForDataScan

FltReleaseContext