Funzione FltInitExtraCreateParameterLookasideList (fltkernel.h)

Articolo
02/06/2025

La routine FltInitExtraCreateParameterLookasideList inizializza un elenco lookaside del pool di paging 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 minifiltro. Questo puntatore identifica in modo univoco il driver minifiltro e rimane costante finché il driver minifiltro viene caricato.

[in, out] Lookaside

Puntatore a un PAGED_LOOKASIDE_LIST opaco o NPAGED_LOOKASIDE_LIST struttura list-head lookaside. Per un elenco di lookaside di paging o non di paging, la struttura list-head deve essere allocata dal 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 con 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 usare 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 di lookaside pool con paging 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 Using Lookaside Lists.

Fabbisogno

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