Funzione FltGetEcpListFromCallbackData (fltkernel.h)

Articolo
02/06/2025

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 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.

[out] EcpList

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

Valore restituito

FltGetEcpListFromCallbackData restituisce uno dei valori NTSTATUS seguenti:

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

Osservazioni

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

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