Funzione FltInsertExtraCreateParameter (fltkernel.h)

Articolo
02/06/2025

La routine FltInsertExtraCreateParameter inserisce una struttura di contesto di creazione aggiuntiva (ECP) 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 minifiltro. Questo puntatore identifica in modo univoco il driver minifiltro e rimane costante finché il driver minifiltro viene caricato.

[in, out] EcpList

Puntatore alla struttura di 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 di 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.

Osservazioni

La routine FltInsertExtraCreateParameter presuppone che la struttura di 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.

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