Funzione FltGetNextExtraCreateParameter (fltkernel.h)

Articolo
02/06/2025

La routine FltGetNextExtraCreateParameter restituisce un puntatore alla struttura di contesto del parametro di creazione successiva (o prima) aggiuntiva in un elenco ECP specificato.

Sintassi

NTSTATUS FLTAPI FltGetNextExtraCreateParameter(
  [in]            PFLT_FILTER Filter,
  [in]            PECP_LIST   EcpList,
  [in, optional]  PVOID       CurrentEcpContext,
  [out, optional] LPGUID      NextEcpType,
  [out, optional] PVOID       *NextEcpContext,
  [out, optional] ULONG       *NextEcpContextSize
);

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] EcpList

Puntatore all'elenco ECP da esaminare.

[in, optional] CurrentEcpContext

Puntatore facoltativo a un ECP nell'elenco ECP specificato. Se presente, FltGetNextExtraCreateParameter restituisce L'ECP dopo CurrentEcpContext ECP. Se CurrentEcpContext è NULL, FltGetNextExtraCreateParameter restituisce il primo ECP nell'elenco.

[out, optional] NextEcpType

Parametro facoltativo che riceve un puntatore al GUID dell'ECP restituito.

[out, optional] NextEcpContext

Parametro facoltativo che riceve un puntatore all'ECP restituito.

[out, optional] NextEcpContextSize

Parametro facoltativo che riceve le dimensioni, in byte, dell'ECP restituito.

Valore restituito

FltGetNextExtraCreateParameter restituisce uno dei valori NTSTATUS seguenti:

Codice restituito	Descrizione
STATUS_SUCCESS	È stato trovato un ECP nell'elenco ECPList.
STATUS_NOT_FOUND	L'elenco EcpList ECP è vuoto o CurrentEcpContext è l'ultimo ECP nell'elenco, ovvero non esiste alcun elemento di elenco ECP successivo). Inoltre, NextEcpContext è impostato su NULL e NextEcpContextSize è impostato su zero.
STATUS_INVALID_PARAMETER	Il parametro EcpList è NULL.

Osservazioni

Questa routine è disponibile a partire da Windows Vista.

La routineFltGetNextExtraCreateParameter elabora un elenco ECP in modo non circolare. Ovvero, se l'ECP a cui punta il parametro CurrentEcpContext è l'ultimo elemento ECP nell'elenco ECP, non esiste un ECP "next" nell'elenco e la routine restituisce STATUS_NOT_FOUND.

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