Freigeben über


FsRtlPrepareToReuseEcp-Funktion (ntifs.h)

Die FsRtlPrepareToReuseEcp Routine setzt eine zusätzliche Create-Parameter(ECP)-Kontextstruktur zurück, die sie für die Wiederverwendung vorbereitet.

Syntax

void FsRtlPrepareToReuseEcp(
  [in] PVOID EcpContext
);

Parameter

[in] EcpContext

Ein Zeiger auf das ECP, um sich auf die Wiederverwendung vorzubereiten.

Rückgabewert

Nichts

Bemerkungen

Die FsRtlPrepareToReuseEcp 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 FsRtlAcknowledgeEcp-, um den ECP als bestätigt zu kennzeichnen. Dies weist darauf hin, dass das ECP erkannt und verarbeitet wurde. Um einen zuvor anerkannten ECP wiederzuverwenden, z. B. bei der Verarbeitung einer Analyse, kann ein Treiber FsRtlPrepareToReuseEcp- verwenden, um den bestätigten Zustand aus dem ECP zu löschen, bevor er ihn in einer anderen Erstellungsanforderung sendet.

Verwenden Sie in einem Dateisystem-Minifiltertreiber FltPrepareToReuseEcp-, um ein ECP wiederzuverwenden.

Anforderungen

Anforderung Wert
mindestens unterstützte Client- Windows 8
Zielplattform- Universal
Header- ntifs.h (einschließlich Ntifs.h)
Library NtosKrnl.lib
DLL- NtosKrnl.exe
IRQL- <= APC_LEVEL

Siehe auch

ECP_LIST

FltPrepareToReuseEcp-

FsRtlInsertExtraCreateParameter

FltIsEcpAcknowledged

FsRtlRemoveExtraCreateParameter