Funzione FltPrepareComplete (fltkernel.h)
La routine FltPrepareComplete riconosce una notifica di TRANSACTION_NOTIFY_PREPARE.
Sintassi
NTSTATUS FLTAPI FltPrepareComplete(
[in] PFLT_INSTANCE Instance,
[in] PKTRANSACTION Transaction,
[in, optional] PFLT_CONTEXT TransactionContext
);
Parametri
[in] Instance
Puntatore dell'istanza opaca per il chiamante.
[in] Transaction
Puntatore di transazione opaco per la transazione.
[in, optional] TransactionContext
Puntatore al contesto delle transazioni del driver minifilter.
Valore restituito
FltPrepareComplete restituisce STATUS_SUCCESS o un valore NTSTATUS appropriato, ad esempio:
Codice restituito | Descrizione |
---|---|
|
Il driver minifilter non ha impostato un contesto sulla transazione. Si tratta di un codice di errore. |
Commenti
Un driver minifilter inserito in una transazione può ricevere una notifica TRANSACTION_NOTIFY_PREPARE quando la transazione entra nella fase di preparazione per il commit. Per inviare la notifica al driver minifilter, gestione filtri chiama la routine TransactionNotificationCallback del driver minifilter. Il driver minifilter riconosce questa notifica in uno dei due modi seguenti:
- La routine TransactionNotificationCallback del driver minifilter esegue qualsiasi elaborazione necessaria e restituisce STATUS_SUCCESS. In questo caso, il driver minifilter non chiama FltPrepareComplete.
- La routine TransactionNotificationCallback del driver minifilter invia qualsiasi elaborazione necessaria a un thread di lavoro e restituisce STATUS_PENDING. Dopo aver eseguito l'elaborazione in modo asincrono, la routine di lavoro del driver minifilter deve chiamare FltPrepareComplete per indicare che l'elaborazione è stata completata. Se la routine di lavoro del driver minifilter non chiama FltPrepareComplete, l'operazione di preparazione della transazione non può essere completata dal gestore delle transazioni del kernel.
Per eseguire l'integrazione in una transazione, chiamare FltEnlistInTransaction.
Per allocare un nuovo contesto di transazione, chiamare FltAllocateContext.
Per recuperare un contesto di transazione, chiamare FltGetTransactionContext.
Per eliminare un contesto di transazione, chiamare FltDeleteTransactionContext o FltDeleteContext.
Per impostare un contesto di transazione, chiamare FltSetTransactionContext.
Requisiti
Requisito | Valore |
---|---|
Client minimo supportato | La routine FltPrepareComplete è disponibile in Windows Vista e versioni successive. |
Piattaforma di destinazione | Universale |
Intestazione | fltkernel.h (include Fltkernel.h) |
Libreria | FltMgr.lib |
DLL | Fltmgr.sys |
IRQL | <= APC_LEVEL |