Funzione FltRemoveExtraCreateParameter (fltkernel.h)

Articolo
02/06/2025

Il FltRemoveExtraCreateParameter routine cerca in un elenco ECP una struttura di contesto ECP e, se trovato, lo scollega dall'elenco ECP.

Sintassi

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

Parametri

[in] Filter

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

[in, out] EcpList

Puntatore all'elenco di parametri di creazione aggiuntivi (ECP) che contiene la struttura del contesto ECP da scollegare dall'elenco specificato.

[in] EcpType

Puntatore a un GUID definito dall'utente che identifica in modo univoco la struttura del contesto ECP da scollegare dall'elenco.

[out] EcpContext

Puntatore alla struttura di contesto ECP scollegata. Se la struttura del contesto ECP viene scollegata correttamente dall'elenco specificato, questo parametro verrà impostato in modo che punti alla struttura di contesto ECP scollegata. Se la struttura di contesto ECP non viene trovata nell'elenco ECP specificato, questo parametro viene impostato su NULL.

[out, optional] EcpContextSize

Parametro facoltativo che riceve le dimensioni della struttura di contesto ECP scollegata. Se questo parametro è presente quando viene chiamata la routine, il parametro riceverà le dimensioni, in byte, della struttura di contesto ECP scollegata. Se la struttura di contesto ECP specificata non è stata trovata nell'elenco ECP specificato, questo parametro non è definito.

Valore restituito

FltRemoveExtraCreateParameter restituisce uno dei valori NTSTATUS seguenti:

Codice restituito	Descrizione
STATUS_SUCCESS	La struttura del contesto ECP specificata è stata scollegata correttamente dall'elenco ECP specificato.
STATUS_NOT_FOUND	La struttura del contesto ECP specificata non è stata trovata nell'elenco ECP specificato.

Osservazioni

La routine FltRemoveExtraCreateParameter cerca nell'elenco ECP fornito dal parametro EcpList per una struttura di contesto ECP specificata dal parametro EcpType. Se la struttura del contesto ECP esiste nell'elenco, viene scollegata dall'elenco, il parametro EcpContext viene impostato in modo che punti a esso e la routine restituisce STATUS_SUCCESS. Se la struttura di contesto ECP non esiste nell'elenco, il parametro EcpContext è impostato su NULL e la routine restituisce STATUS_NOT_FOUND.

Nota Questa routine non libera il pool di memoria per la struttura del contesto ECP. Per liberare la struttura del contesto ECP, chiamare prima questa routine per scollegarla dall'elenco e quindi chiamare la routine FltFreeExtraCreateParameter per liberare la struttura del contesto ECP stessa.

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