Funzione FltInitExtraCreateParameterLookasideList (fltkernel.h)

Articolo
02/26/2024

La routine FltInitExtraCreateParameterLookasideList inizializza un elenco lookaside del pool impaginato o non di paging utilizzato per l'allocazione di una o più strutture di contesto dei parametri create aggiuntive di dimensioni fisse.

Sintassi

VOID FLTAPI FltInitExtraCreateParameterLookasideList(
  [in]      PFLT_FILTER               Filter,
  [in, out] PVOID                     Lookaside,
  [in]      FSRTL_ECP_LOOKASIDE_FLAGS Flags,
  [in]      SIZE_T                    Size,
  [in]      ULONG                     Tag
);

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, out] Lookaside

Puntatore a un PAGED_LOOKASIDE_LIST opaco o NPAGED_LOOKASIDE_LIST struttura di intestazione elenco lookaside. Per un elenco lookaside di paging o non di paging, la struttura list-head deve essere allocata da un pool non di paging.

[in] Flags

Definisce le opzioni di allocazione del pool. Se il parametro Flags contiene il valore del flag di bit FSRTL_ECP_LOOKASIDE_FLAG_NONPAGED_POOL, la routine inizializza un elenco lookaside per le voci ECP non di paging delle dimensioni specificate. In caso contrario, la routine inizializza un elenco lookaside per le voci ECP di paging delle dimensioni specificate.

[in] Size

Specifica le dimensioni, in byte, per tutte le voci ECP nell'elenco lookaside.

[in] Tag

Specifica il tag del pool da utilizzare per l'allocazione delle voci ECP dell'elenco lookaside. Per altre informazioni sui tag del pool, vedere il parametro Tag di ExAllocatePoolWithTag.

Valore restituito

nessuno

Osservazioni

Utilizzare questa routine per inizializzare un elenco lookaside del pool impaginato o non di paging. Utilizzare la routine FltAllocateExtraCreateParameterFromLookasideList per allocare un ECP dall'elenco lookaside e la routine FltFreeExtraCreateParameter per restituire un buffer ECP all'elenco lookaside per il riciclo.

Utilizzare la routine FltDeleteExtraCreateParameterLookasideList per liberare l'elenco lookaside stesso.

I driver devono liberare tutti gli ecp e gli elenchi lookaside creati prima dello scaricamento.

Per altre informazioni sull'uso di elenchi lookaside con driver, vedere Uso di Lookaside Elenchi.

Requisiti

Requisito	Valore
Client minimo supportato	La routine FltInitExtraCreateParameterLookasideList è 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