Funzione FltGetNextExtraCreateParameter (fltkernel.h)

Articolo
08/07/2023

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

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 minifilter. Questo puntatore identifica in modo univoco il driver minifilter e rimane costante finché il driver minifilter 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	Un ECP è stato trovato nell'elenco EcpList ECP.
STATUS_NOT_FOUND	L'elenco EcpList ECP è vuoto o CurrentEcpContext è l'ultimo ECP nell'elenco, 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.

Commenti

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, nell'elenco non è presente alcun ECP "next" e la routine restituisce STATUS_NOT_FOUND.

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