FltDoCompletionProcessingWhenSafe-Funktion (fltkernel.h)

Artikel
08/07/2023

Wenn dies sicher ist, führt die FltDoCompletionProcessingWhenSafe-Funktion eine Rückrufroutine für minifilter-Treiber nach dem Vorgang aus.

Syntax

BOOLEAN FLTAPI FltDoCompletionProcessingWhenSafe(
  [in]           PFLT_CALLBACK_DATA           Data,
  [in]           PCFLT_RELATED_OBJECTS        FltObjects,
  [in, optional] PVOID                        CompletionContext,
  [in]           FLT_POST_OPERATION_FLAGS     Flags,
  [in]           PFLT_POST_OPERATION_CALLBACK SafePostCallback,
  [out]          PFLT_POSTOP_CALLBACK_STATUS  RetPostOperationStatus
);

Parameter

[in] Data

Zeiger auf die Rückrufdatenstruktur (FLT_CALLBACK_DATA) für den E/A-Vorgang. Normalerweise entspricht dies dem Datenzeiger , der an die Postoperation-Rückrufroutine (PFLT_POST_OPERATION_CALLBACK) übergeben wurde, die FltDoCompletionProcessingWhenSafe aufgerufen hat.

[in] FltObjects

Zeiger auf die zugehörige Objektstruktur (FLT_RELATED_OBJECTS) für den E/A-Vorgang. In der Regel entspricht dies dem FltObjects-Zeiger , der an die Rückrufroutine nach der Operation übergeben wurde, die FltDoCompletionProcessingWhenSafe aufgerufen hat.

[in, optional] CompletionContext

Zeiger auf eine vom Aufrufer bereitgestellte Kontextinformation, die an die Rückruffunktion übergeben wird, die im SafePostCallback-Parameter angegeben ist.

[in] Flags

Bitmaske von Flags, die angeben, wie die Vervollständigungsverarbeitung ausgeführt wird. In der Regel entspricht dies dem Flags-Wert , der an die Rückrufroutine nach der Operation übergeben wurde, die FltDoCompletionProcessingWhenSafe aufgerufen hat. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".

[in] SafePostCallback

Zeiger auf eine vom Anrufer bereitgestellte PFLT_POST_OPERATION_CALLBACK typisierte Rückrufroutine, die das Betriebssystem aufruft, wenn dies sicher ist.

[out] RetPostOperationStatus

Vom Aufrufer zugewiesene Variable, die den endgültigen status Wert für den E/A-Vorgang empfängt. Weitere Informationen zum Festlegen dieses Parameters finden Sie im abschnitt "Hinweise".

Rückgabewert

FltDoCompletionProcessingWhenSafe gibt TRUE zurück, wenn die Abschlussverarbeitung für den E/A-Vorgang sofort ausgeführt werden kann oder der E/A-Vorgang erfolgreich an einen Workerthread gesendet wurde; Andernfalls wird FALSE zurückgegeben.

Hinweise

FltDoCompletionProcessingWhenSafe führt den SafePostCallback sofort aus, wenn der Aufrufer unter IRQL <= APC_LEVEL ausgeführt wird. Andernfalls wird die SafePostCallback-Verarbeitung zurückgestellt, wenn es sicher ist, den Vorgang in einem Workerthread zu posten, bis sie in einem Threadkontext aufgerufen werden kann, in dem IRQL <= APC_LEVEL.

Wenn IRQL < DISPATCH_LEVEL:

FltDoCompletionProcessingWhenSafe ruft sofort die Rückrufroutine SafePostCallback auf.
Der Parameter RetPostOperationStatus empfängt einen FLT_POSTOP_CALLBACK_STATUS Wert, der von SafePostCallback zurückgegeben wird.
FltDoCompletionProcessingWhenSafe gibt TRUE zurück.

Wenn IRQL >= DISPATCH_LEVEL:

FltDoCompletionProcessingWhenSafe versucht, den E/A-Vorgang in einem Workerthread zu posten und dann die SafePostCallback-Routine aus dem Workerthread aufzurufen.
Wenn der E/A-Vorgang sicher veröffentlicht werden konnte:
- Der Filter-Manager legt RetPostOperationStatus auf FLT_POSTOP_MORE_PROCESSING_REQUIRED fest.
- FltDoCompletionProcessingWhenSafe gibt TRUE zurück.
Wenn der E/A-Vorgang nicht sicher veröffentlicht werden konnte:
- Der Filter-Manager legt RetPostOperationStatus auf FLT_POSTOP_FINISHED_PROCESSING fest.
- FltDoCompletionProcessingWhenSafe gibt FALSE zurück.

FltDoCompletionProcessingWhenSafe kann nur für IRP-basierte Vorgänge aufgerufen werden. Verwenden Sie das Makro FLT_IS_IRP_OPERATION , um zu ermitteln, ob es sich bei dem Vorgang um einen IRP-basierten Vorgang handelt.

FltDoCompletionProcessingWhenSafe kann nicht verwendet werden, um den Abschluss eines Paging-E/A-Vorgangs in einem Workerthread nachzuvollständigen.

FltDoCompletionProcessingWhenSafe kann nur über die Postoperation-Rückrufroutine eines Minifiltertreibers (PFLT_POST_OPERATION_CALLBACK) aufgerufen werden. Beachten Sie, dass FltDoCompletionProcessingWhenSafe niemals aufgerufen werden sollte, wenn für den Flags-Parameter des Postoperation-Rückrufs das FLTFL_POST_OPERATION_DRAINING Bit festgelegt ist.

Wenn ein Minifilter FltDoCompletionProcessingWhenSafe aufruft und der SafePostCallback in einem Workerthread aufgerufen wird, weil es nicht sicher ist, ihn im aktuellen Threadkontext aufzurufen, setzt der Filter-Manager die Verarbeitung der Abschluss fort, solange der Minifilter nicht FLT_POSTOP_MORE_PROCESSING_REQUIRED aus dem SafePostCallback zurückgibt.

Wenn der Minifilter FLT_POSTOP_MORE_PROCESSING_REQUIRED aus dem SafePostCallback zurückgibt, muss der Minifilter FltCompletePendedPostOperation aufrufen, um die Abschlussverarbeitung fortzusetzen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Microsoft Windows 2000 UpdateRollup 1 für SP4, Windows XP SP2, Windows Server 2003 SP1 und höher. Nicht verfügbar in Windows 2000 SP4 und früheren Betriebssystemen.
Zielplattform	Universell
Header	fltkernel.h (include Fltkernel.h)
Bibliothek	Fltmgr.lib
IRQL	Alle.