FltPrepareToReuseEcp-Funktion (fltkernel.h)

Artikel
03/01/2024

Die FltPrepareToReuseEcp-Routine setzt eine ECP-Kontextstruktur (extra create parameter) zurück, die sie für die Wiederverwendung vorbereitet.

Syntax

VOID FLTAPI FltPrepareToReuseEcp(
  [in] PFLT_FILTER Filter,
  [in] PVOID       EcpContext
);

Parameter

[in] Filter

Ein undurchsichtiger Filterzeiger für den Minifiltertreiber. Dieser Zeiger identifiziert den Minifiltertreiber eindeutig und bleibt konstant, solange der Minifiltertreiber geladen wird.

[in] EcpContext

Ein Zeiger auf den ECP zur Vorbereitung auf die Wiederverwendung.

Rückgabewert

Keine.

Hinweise

FltPrepareToReuseEcp ermöglicht die Wiederverwendung eines ECP, das in einer vorherigen Erstellungsanforderung verwendet wurde. Dadurch wird verhindert, dass ein neuer ECP mit den gleichen Informationen initialisiert werden muss.

Das Ziel eines ECP verwendet FltAcknowledgeEcp , um den ECP als bestätigt zu markieren. Dies gibt an, dass der ECP ermittelt und verarbeitet wurde. Um einen zuvor bestätigten ECP wiederzuverwenden, z. B. bei der Verarbeitung einer Analyse, kann ein Treiber FltPrepareToReuseEcp verwenden, um den bestätigten Zustand aus dem ECP zu löschen, bevor er in einer anderen Erstellungsanforderung gesendet wird.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar ab Windows 8.
Zielplattform	Universell
Header	fltkernel.h (fltkernel.h einschließen)
Bibliothek	FltMgr.lib
DLL	Fltmgr.sys
IRQL	<= APC_LEVEL