FltGetEcpListFromCallbackData-Funktion (fltkernel.h)

Artikel
03/01/2024

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