FltSetEcpListIntoCallbackData-Funktion (fltkernel.h)

Artikel
03/01/2024

Die FltSetEcpListIntoCallbackData-Routine fügt eine zusätzliche ECP-Liste (Create Parameter Context Structure) an ein Create Operation Callback-data-Objekt an.

Syntax

NTSTATUS FLTAPI FltSetEcpListIntoCallbackData(
  [in] PFLT_FILTER        Filter,
       PFLT_CALLBACK_DATA CallbackData,
  [in] PECP_LIST          EcpList
);

Parameter

[in] Filter

Undurchsichtiger Filterzeiger auf den Minifiltertreiber. Dieser Zeiger identifiziert den Minifiltertreiber eindeutig und bleibt konstant, solange der Minifiltertreiber geladen wird.

CallbackData

Zeiger auf ein Rückrufdatenobjekt vom Typ FLT_CALLBACK_DATA, das den Erstellungsvorgang darstellt.

[in] EcpList

Zeiger auf die ECP-Liste, die ein oder mehrere ECPs enthält, die an das Rückrufdatenobjekt angefügt werden sollen.

Rückgabewert

FltSetEcpListIntoCallbackData gibt einen der folgenden NTSTATUS-Werte zurück:

Rückgabecode	Beschreibung
STATUS_SUCCESS	Die angegebene ECP-Liste wurde erfolgreich an das angegebene Rückrufdatenobjekt angefügt.
STATUS_INVALID_PARAMETER_2	Das angegebene Rückrufdatenobjekt war kein IRP-basierter Erstellungsvorgang.
STATUS_INVALID_PARAMETER_3	An das angegebene Rückrufdatenobjekt wurde bereits eine ECP-Liste angefügt.

Hinweise

Die FltSetEcpListIntoCallbackData-Routine bietet einen Mechanismus zum Übergeben zusätzlicher Erstellungsparameter im Dateisystemfilterstapel an zugrunde liegende Minifilter- und Legacyfiltertreiber.

Verwenden Sie die FltGetEcpListFromCallbackData-Routine , um eine angefügte ECP-Liste aus einem bestimmten callback-data-Objekt abzurufen.

Anforderungen

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