Função FltGetStreamHandleContext (fltkernel.h)

Artigo
02/29/2024

A rotina FltGetStreamHandleContext recupera um contexto que foi definido para um identificador de fluxo por uma determinada instância de driver de minifiltro.

Sintaxe

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

Parâmetros

[in] Instance

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

[in] FileObject

Ponteiro para um objeto de arquivo para o identificador de fluxo.

[out] Context

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

Retornar valor

FltGetStreamHandleContext retorna STATUS_SUCCESS quando retorna com êxito o contexto 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 sistema de arquivos não dá suporte a contextos por fluxo para esse fluxo de arquivos. Este é um código de erro.

Comentários

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

FltGetStreamHandleContext recupera um contexto que foi definido para um identificador de fluxo por um determinado driver de minifiltro.

FltGetStreamHandleContext 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 FltGetStreamHandleContext deve ser correspondida por uma chamada subsequente para FltReleaseContext.

Para definir um contexto para um identificador de fluxo, chame FltSetStreamHandleContext

Para alocar um novo contexto, chame FltAllocateContext.

Para excluir um contexto de identificador de fluxo, chame FltDeleteStreamHandleContext ou FltDeleteContext.