Freigeben über


FltGetEcpListFromCallbackData-Funktion (fltkernel.h)

Die FltGetEcpListFromCallbackData-Routine gibt einen Zeiger auf eine zusätzliche ECP-Liste (Create Parameter Context Structure) zurück, die einem bestimmten Callback-Data-Objekt für einen bestimmten Create-Vorgang zugeordnet ist.

Syntax

NTSTATUS FLTAPI FltGetEcpListFromCallbackData(
  [in]  PFLT_FILTER        Filter,
        PFLT_CALLBACK_DATA CallbackData,
  [out] PECP_LIST          *EcpList
);

Parameter

[in] Filter

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

CallbackData

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

[out] EcpList

Empfängt einen Zeiger auf die ECP-Liste, die dem CallbackData-Rückrufdatenobjekt zugeordnet ist.

Rückgabewert

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

Rückgabecode Beschreibung
STATUS_SUCCESS
EcpList hat einen Zeiger auf die ECP-Liste erhalten, die dem angegebenen Rückrufdatenobjekt zugeordnet ist. Wenn dem Rückrufdatenobjekt kein ECP zugeordnet ist, wird STATUS_SUCCESS zurückgegeben, und EcpList ist NULL.
STATUS_INVALID_PARAMETER
Das angegebene Rückrufdatenobjekt war kein IRP-basierter Erstellungsvorgang. In diesem Fall ist EcpList nicht definiert.

Hinweise

Um eine ECP-Liste an ein Rückrufdatenobjekt anzufügen, verwenden Sie die FltSetEcpListIntoCallbackData-Routine .

Anforderungen

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

Weitere Informationen

ECP_LIST

FLT_CALLBACK_DATA

FltAcknowledgeEcp

FltAllocateExtraCreateParameter

FltAllocateExtraCreateParameterFromLookasideList

FltAllocateExtraCreateParameterList

FltCreateFileEx2

FltDeleteExtraCreateParameterLookasideList

FltFindExtraCreateParameter

FltFreeExtraCreateParameter

FltFreeExtraCreateParameterList

FltGetNextExtraCreateParameter

FltInitExtraCreateParameterLookasideList

FltInsertExtraCreateParameter

FltIsEcpAcknowledged

FltIsEcpFromUserMode

FltRemoveExtraCreateParameter

FltSetEcpListIntoCallbackData

IoCreateFileEx