Funzione FltFindExtraCreateParameter (fltkernel.h)

Articolo
02/29/2024

La routine FltFindExtraCreateParameter cerca un elenco ECP specificato per una struttura di contesto ECP di un determinato tipo e restituisce un puntatore a questa struttura se viene trovato.

Sintassi

NTSTATUS FLTAPI FltFindExtraCreateParameter(
  [in]            PFLT_FILTER Filter,
  [in]            PECP_LIST   EcpList,
  [in]            LPCGUID     EcpType,
  [out, optional] PVOID       *EcpContext,
  [out, optional] ULONG       *EcpContextSize
);

Parametri

[in] Filter

Puntatore filtro opaco per il driver minifilter. Questo puntatore identifica in modo univoco il driver minifilter e rimane costante finché viene caricato il driver minifilter.

[in] EcpList

Puntatore alla struttura di elenco ECP in cui cercare la struttura del contesto ECP (specificata dal parametro EcpType ).

[in] EcpType

Puntatore a un GUID che identifica in modo univoco ogni struttura di contesto ECP. Questo valore GUID viene usato dalla routine FltFindExtraCreateParamter per determinare se la struttura del contesto ECP esiste nell'elenco ECP (dato dal parametro EcpList ).

[out, optional] EcpContext

Parametro facoltativo che riceve un puntatore alla struttura di contesto ECP trovata. Se la struttura del contesto ECP non viene trovata nell'elenco ECP, EcpContext è impostata su NULL. Se EcpContext è impostato su NULL dal chiamante, il valore restituito di questa routine può essere usato per determinare se la struttura del contesto ECP si trova nell'elenco ECP.

[out, optional] EcpContextSize

Parametro facoltativo che riceve le dimensioni, in byte, della struttura di contesto ECP trovata. Se la struttura del contesto ECP non viene trovata nell'elenco ECP, EcpContextSize è impostata su zero.

Valore restituito

FltFindExtraCreateParameter restituisce uno dei valori NTSTATUS seguenti:

Codice restituito	Descrizione
STATUS_SUCCESS	La struttura del contesto ECP (come specificato dal parametro EcpType ) è stata trovata nell'elenco ECP (come specificato dal parametro EcpList ).
STATUS_NOT_FOUND	La struttura del contesto ECP (come specificato dal parametro EcpType ) non è stata trovata nell'elenco ECP (come specificato dal parametro EcpList ).

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