Funzione FltGetTransactionContext (fltkernel.h)
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 |