Função FltGetTransactionContext (fltkernel.h)
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 por chamador que recebe o endereço do contexto da transação.
Valor de retorno
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. |
Observações
Para obter mais informações sobre contextos, consulte Sobre contextos de minifiltro.
FltGetTransactionContext incrementa a contagem de referência no contexto ao qual o parâmetro de Contexto 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 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.
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Universal |
| cabeçalho | fltkernel.h (inclua Fltkernel.h) |
| biblioteca | FltMgr.lib |
| de DLL | FltMgr.sys |
| IRQL | <= APC_LEVEL |