Funzione FltRemoveExtraCreateParameter (fltkernel.h)

Articolo
02/26/2024

La routine FltRemoveExtraCreateParameter cerca in un elenco ECP una struttura di contesto ECP e, se presente, la 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 minifilter. Questo puntatore identifica in modo univoco il driver minifilter e rimane costante finché il driver minifilter viene caricato.

[in, out] EcpList

Puntatore all'elenco di parametri di creazione aggiuntivi (ECP) che contiene la struttura di 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 del contesto ECP non viene trovata nell'elenco ECP specificato, questo parametro è 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 del 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.

Commenti

La routine FltRemoveExtraCreateParameter cerca nell'elenco ECP specificato dal parametro EcpList 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 per puntare a esso e la routine restituisce STATUS_SUCCESS. Se la struttura del contesto ECP non esiste nell'elenco, il parametro EcpContext viene 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.

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