Freigeben über


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
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 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

ECP_LIST

FLT_CALLBACK_DATA

FltAcknowledgeEcp

FltAllocateExtraCreateParameter

FltAllocateExtraCreateParameterFromLookasideList

FltAllocateExtraCreateParameterList

FltCreateFileEx2

FltDeleteExtraCreateParameterLookasideList

FltFindExtraCreateParameter

FltFreeExtraCreateParameter

FltFreeExtraCreateParameterList

FltGetEcpListFromCallbackData

FltGetNextExtraCreateParameter

FltInitExtraCreateParameterLookasideList

FltInsertExtraCreateParameter

FltIsEcpAcknowledged

FltIsEcpFromUserMode

FltRemoveExtraCreateParameter

IoCreateFileEx-