Funzione FltSetEcpListIntoCallbackData (fltkernel.h)

Articolo
02/06/2025

La routine FltSetEcpListIntoCallbackData associa un elenco ECP (Create Parameter Context Structure) aggiuntivo a un oggetto callback-data dell'operazione di creazione.

Sintassi

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

Parametri

[in] Filter

Puntatore di filtro opaco al driver minifiltro. Questo puntatore identifica in modo univoco il driver minifiltro e rimane costante finché il driver minifiltro viene caricato.

CallbackData

Puntatore a un oggetto callback-data di tipo FLT_CALLBACK_DATA, che rappresenta l'operazione di creazione.

[in] EcpList

Puntatore all'elenco ECP, che contiene uno o più ecp, da associare all'oggetto callback-data.

Valore restituito

FltSetEcpListIntoCallbackData restituisce uno dei valori NTSTATUS seguenti:

Codice restituito	Descrizione
STATUS_SUCCESS	L'elenco ECP specificato è stato associato correttamente all'oggetto callback-data specificato.
STATUS_INVALID_PARAMETER_2	L'oggetto dati di callback specificato non era un'operazione di creazione basata su IRP.
STATUS_INVALID_PARAMETER_3	Un elenco ECP è già stato associato all'oggetto callback-data specificato.

Osservazioni

La routine FltSetEcpListIntoCallbackData fornisce un meccanismo per passare parametri di creazione aggiuntivi allo stack di filtri del file system ai driver di filtro minifiltro e legacy sottostanti.

Per recuperare un elenco ECP associato da un determinato oggetto callback-data, utilizzare la routine FltGetEcpListFromCallbackData.

Fabbisogno

Requisito	Valore
client minimo supportato	Questa routine è disponibile a partire da Windows Vista.
piattaforma di destinazione	Universale
intestazione	fltkernel.h (include Fltkernel.h)
libreria	FltMgr.lib
dll	Fltmgr.sys
IRQL	<= APC_LEVEL