FltPrepareToReuseEcp-Funktion (fltkernel.h)
Die FltPrepareToReuseEcp Routine setzt eine zusätzliche Create-Parameter(ECP)-Kontextstruktur 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 das ECP, um sich auf die Wiederverwendung vorzubereiten.
Rückgabewert
Nichts.
Bemerkungen
Die FltPrepareToReuseEcp- ermöglicht die Wiederverwendung eines ECP, das in einer vorherigen Erstellungsanforderung verwendet wird. Dadurch wird verhindert, dass ein neues ECP mit denselben Informationen initialisiert werden muss.
Das Ziel eines ECP verwendet FltAcknowledgeEcp-, um den ECP als anerkannt zu kennzeichnen. Dies weist darauf hin, dass das ECP erkannt und verarbeitet wurde. Um einen zuvor anerkannten ECP wie z. B. bei der Verarbeitung einer Analyse wiederzuverwenden, kann ein Treiber FltPrepareToReuseEcp- verwenden, um den bestätigten Zustand aus dem ECP zu löschen, bevor er sie in einer anderen Erstellungsanforderung sendet.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar ab Windows 8. |
| Zielplattform- | Universal |
| Header- | fltkernel.h (include Fltkernel.h) |
| Library | FltMgr.lib |
| DLL- | Fltmgr.sys |
| IRQL- | <= APC_LEVEL |