Funzione FltInsertExtraCreateParameter (fltkernel.h)

Articolo
08/07/2023

La routine FltInsertExtraCreateParameter inserisce una struttura di contesto ECP (Create Parameter) aggiuntiva in un elenco ECP.

Sintassi

NTSTATUS FLTAPI FltInsertExtraCreateParameter(
  [in]      PFLT_FILTER Filter,
  [in, out] PECP_LIST   EcpList,
  [in, out] PVOID       EcpContext
);

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.

[in, out] EcpList

Puntatore alla struttura dell'elenco ECP a cui deve essere aggiunta la struttura del contesto ECP, fornita dal parametro EcpContext .

[in, out] EcpContext

Puntatore alla struttura del contesto ECP da aggiungere all'elenco ECP, fornito dal parametro EcpList .

Valore restituito

FltInsertExtraCreateParameter restituisce uno dei valori NTSTATUS seguenti:

Codice restituito	Descrizione
STATUS_SUCCESS	La struttura del contesto ECP specificata è stata inserita correttamente nell'elenco ECP specificato.
STATUS_INVALID_PARAMETER	La struttura del contesto ECP specificata esiste già nell'elenco ECP specificato. Nel contesto dell'inserimento dell'elenco ECP, due strutture di contesto ECP vengono considerate identiche se contengono valori GUID uguali.

Commenti

La routine FltInsertExtraCreateParameter presuppone che la struttura del contesto ECP specificata venga inserita nell'elenco ECP specificato sia stata precedentemente allocata dalla routine FltAllocateExtraCreateParameter .

Ogni struttura di contesto ECP inserita nell'elenco ECP deve avere un valore GUID univoco. Questo valore univoco viene impostato quando la struttura del contesto ECP viene allocata dalla routine FltAllocateExtraCreateParameter .

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