Funzione FltSetEcpListIntoCallbackData (fltkernel.h)

Articolo
08/07/2023

La routine FltSetEcpListIntoCallbackData collega un elenco di contesto dei parametri di creazione aggiuntivo (ECP) 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 minifilter. Questo puntatore identifica in modo univoco il driver minifilter e rimane costante finché viene caricato il driver minifilter.

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 collegare all'oggetto callback-data.

Valore restituito

FltSetEcpListIntoCallbackData restituisce uno dei valori NTSTATUS seguenti:

Codice restituito	Descrizione
STATUS_SUCCESS	L'elenco ECP specificato è stato collegato 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 collegato all'oggetto callback-data specificato.

Commenti

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

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

Requisiti

Requisito	Valore
Client minimo supportato	Questa routine è disponibile a partire da Windows Vista.
Piattaforma di destinazione	Universale
Intestazione	fltkernel.h (includere Fltkernel.h)
Libreria	FltMgr.lib
DLL	Fltmgr.sys
IRQL	<= APC_LEVEL