Funzione FltGetEcpListFromCallbackData (fltkernel.h)

Articolo
08/07/2023

La routine FltGetEcpListFromCallbackData restituisce un puntatore a un elenco ECP (Create Parameter Context Structure) aggiuntivo associato a un determinato oggetto callback-data dell'operazione di creazione.

Sintassi

NTSTATUS FLTAPI FltGetEcpListFromCallbackData(
  [in]  PFLT_FILTER        Filter,
        PFLT_CALLBACK_DATA CallbackData,
  [out] 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é il driver minifilter viene caricato.

CallbackData

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

[out] EcpList

Riceve un puntatore all'elenco ECP associato all'oggetto callbackData callback-data .

Valore restituito

FltGetEcpListFromCallbackData restituisce uno dei valori NTSTATUS seguenti:

Codice restituito	Descrizione
STATUS_SUCCESS	EcpList ha ricevuto un puntatore all'elenco ECP associato all'oggetto callback-data specificato. Se l'oggetto callback-data non dispone di un ECP associato, STATUS_SUCCESS viene restituito e EcpList è NULL.
STATUS_INVALID_PARAMETER	L'oggetto callback-data specificato non è un'operazione di creazione basata su IRP. In questo caso , EcpList non è definito.

Commenti

Per collegare un elenco ECP a un oggetto callback-data, utilizzare la routine FltSetEcpListIntoCallbackData .

Requisiti

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