Função FltGetTransactionContext (fltkernel.h)

Artigo
02/26/2024

A rotina FltGetTransactionContext recupera um contexto que foi definido para uma transação por um determinado driver de minifiltro.

Sintaxe

NTSTATUS FLTAPI FltGetTransactionContext(
  [in]  PFLT_INSTANCE Instance,
  [in]  PKTRANSACTION Transaction,
  [out] PFLT_CONTEXT  *Context
);

Parâmetros

[in] Instance

Ponteiro de instância opaco para o chamador.

[in] Transaction

Ponteiro de transação opaco para a transação cujo contexto está sendo recuperado.

[out] Context

Ponteiro para uma variável alocada pelo chamador que recebe o endereço do contexto da transação.

Retornar valor

FltGetTransactionContext 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.

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

Para definir um contexto para uma transação, chame FltSetTransactionContext.

Para alocar um novo contexto de transação, chame FltAllocateContext.

Para excluir um contexto de transação, chame FltDeleteTransactionContext ou FltDeleteContext.