Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
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 |
|---|---|
|
È stato trovato un ECP nell'elenco ECPList. |
|
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. |
|
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 |
Vedere anche
FltAllocateExtraCreateParameter
FltAllocateExtraCreateParameterFromLookasideList
FltAllocateExtraCreateParameterList