FltCommitComplete-Funktion (fltkernel.h)
Die FltCommitComplete-Routine bestätigt eine TRANSACTION_NOTIFY_COMMIT Benachrichtigung.
Syntax
NTSTATUS FLTAPI FltCommitComplete(
[in] PFLT_INSTANCE Instance,
[in] PKTRANSACTION Transaction,
[in, optional] PFLT_CONTEXT TransactionContext
);
Parameter
[in] Instance
Undurchsichtiger instance Zeiger für den Aufrufer.
[in] Transaction
Undurchsichtiger Transaktionszeiger für die Transaktion.
[in, optional] TransactionContext
Zeiger auf den Kontext des Minifiltertreibers für die Transaktion. Dieser Parameter ist optional und kann NULL sein.
Rückgabewert
FltCommitComplete gibt STATUS_SUCCESS oder einen geeigneten NTSTATUS-Wert wie den folgenden zurück:
Rückgabecode | Beschreibung |
---|---|
|
Der Minifiltertreiber hat keinen Kontext für die Transaktion festgelegt. Dies ist ein Fehlercode. |
Hinweise
Diese Routine ist unter Windows Vista und höher verfügbar.
Ein Minifiltertreiber, der in einer Transaktion eingetragen ist, kann eine TRANSACTION_NOTIFY_COMMIT Benachrichtigung erhalten, wenn für die Transaktion ein Commit ausgeführt wird. Um die Benachrichtigung an den Minifiltertreiber zu senden, ruft der Filter-Manager die TransactionNotificationCallback-Routine des Minifiltertreibers auf. Der Minifiltertreiber bestätigt diese Benachrichtigung auf zwei Arten:
- Die TransactionNotificationCallback-Routine des Minifiltertreibers führt alle erforderlichen Verarbeitungsvorgänge durch und gibt STATUS_SUCCESS zurück. In diesem Fall ruft der Minifiltertreiber FltCommitComplete nicht auf.
- Die TransactionNotificationCallback-Routine des Minifiltertreibers sendet alle erforderlichen Verarbeitungen an einen Workerthread und gibt STATUS_PENDING zurück. Nachdem die Verarbeitung asynchron ausgeführt wurde, muss die Arbeitsroutine des Minifiltertreibers FltCommitComplete aufrufen, um anzugeben, dass diese Verarbeitung abgeschlossen wurde. Wenn die Arbeitsroutine des Minifiltertreibers FltCommitComplete nicht aufruft, kann der Transaktionscommitvorgang nicht vom Kerneltransaktions-Manager abgeschlossen werden.
Rufen Sie FltEnlistInTransaction auf, um sich in eine Transaktion ein eintragen zu können.
Um einen neuen Transaktionskontext zuzuordnen, rufen Sie FltAllocateContext auf.
Um einen Transaktionskontext abzurufen, rufen Sie FltGetTransactionContext auf.
Um einen Transaktionskontext zu löschen, rufen Sie FltDeleteTransactionContext oder FltDeleteContext auf.
Um einen Transaktionskontext festzulegen, rufen Sie FltSetTransactionContext auf.
Anforderungen
Anforderung | Wert |
---|---|
Zielplattform | Universell |
Header | fltkernel.h (fltkernel.h einschließen) |
Bibliothek | Fltmgr.lib |
IRQL | PASSIVE_LEVEL |