Funzione FltGetTransactionContext (fltkernel.h)

Articolo
08/07/2023

La routine FltGetTransactionContext recupera un contesto impostato per una transazione da un determinato driver minifilter.

Sintassi

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

Parametri

[in] Instance

Puntatore istanza opaca per il chiamante.

[in] Transaction

Puntatore transazionale opaco per la transazione il cui contesto viene recuperato.

[out] Context

Puntatore a una variabile allocata dal chiamante che riceve l'indirizzo del contesto della transazione.

Valore restituito

FltGetTransactionContext restituisce STATUS_SUCCESS o un valore NTSTATUS appropriato, ad esempio quanto segue:

Codice restituito	Descrizione
STATUS_NOT_FOUND	Non è stato trovato alcun contesto corrispondente. Si tratta di un codice di errore.

Commenti

Per altre informazioni sui contesti, vedere Informazioni sui contesti minifilter.

FltGetTransactionContext incrementa il conteggio dei riferimenti nel contesto a cui punta il parametro Context . Quando questo puntatore di contesto non è più necessario, il chiamante deve decrementare il conteggio dei riferimenti chiamando FltReleaseContext. Pertanto ogni chiamata riuscita a FltGetTransactionContext deve essere corrispondente a una chiamata successiva a FltReleaseContext.

Per impostare un contesto per una transazione, chiamare FltSetTransactionContext.

Per allocare un nuovo contesto di transazione, chiamare FltAllocateContext.

Per eliminare un contesto di transazione, chiamare FltDeleteTransactionContext o FltDeleteContext.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Universale
Intestazione	fltkernel.h (includere Fltkernel.h)
Libreria	FltMgr.lib
DLL	FltMgr.sys
IRQL	<= APC_LEVEL