FltSetEcpListIntoCallbackData-Funktion (fltkernel.h)
Die FltSetEcpListIntoCallbackData Routine fügt eine zusätzliche Create-Parameterkontextstruktur (ECP)-Liste an ein Callback-Data-Objekt für den Erstellungsvorgang 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 einen 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 |
---|---|
|
Die angegebene ECP-Liste wurde erfolgreich an das angegebene Rückrufdatenobjekt angefügt. |
|
Das angegebene Rückrufdatenobjekt war kein IRP-basierter Erstellungsvorgang. |
|
An das angegebene Callback-Data-Objekt wurde bereits eine ECP-Liste angefügt. |
Bemerkungen
Die FltSetEcpListIntoCallbackData Routine bietet einen Mechanismus zum Übergeben zusätzlicher Erstellungsparameter an den zugrunde liegenden Minifilter- und Legacyfiltertreiber.
Um eine angefügte ECP-Liste aus einem bestimmten Rückrufdatenobjekt abzurufen, verwenden Sie die FltGetEcpListFromCallbackData Routine.
Anforderungen
Anforderung | Wert |
---|---|
mindestens unterstützte Client- | Diese Routine ist ab Windows Vista verfügbar. |
Zielplattform- | Universal |
Header- | fltkernel.h (include Fltkernel.h) |
Library | FltMgr.lib |
DLL- | Fltmgr.sys |
IRQL- | <= APC_LEVEL |
Siehe auch
FltAllocateExtraCreateParameter
FltAllocateExtraCreateParameterFromLookasideList
FltAllocateExtraCreateParameterList
FltDeleteExtraCreateParameterLookasideList
FltFreeExtraCreateParameterList
FltGetNextExtraCreateParameter