Funzione FsRtlInitExtraCreateParameterLookasideList (ntifs.h)

Articolo
12/20/2024

La routine FsRtlInitExtraCreateParameterLookasideList inizializza un elenco lookaside del pool impaginato o non di pagina utilizzato per l'allocazione di una o più strutture di contesto di creazione dei parametri aggiuntive (ECP) di dimensioni fisse.

Sintassi

void FsRtlInitExtraCreateParameterLookasideList(
  [in, out] PVOID                     Lookaside,
  [in]      FSRTL_ECP_LOOKASIDE_FLAGS Flags,
  [in]      SIZE_T                    Size,
  [in]      ULONG                     Tag
);

Parametri

[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 pagina, 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, FsRtlInitExtraCreateParameterLookasideList inizializza un elenco lookaside per le voci ECP non di pagina delle dimensioni specificate. In caso contrario, FsRtlInitExtraCreateParameterLookasideList 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 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 pagina. Utilizzare la routine FsRtlAllocateExtraCreateParameterFromLookasideList per allocare un ECP dall'elenco lookaside e la routine FsRtlFreeExtraCreateParameter per restituire un buffer ECP all'elenco lookaside per il riciclo.

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

I driver devono liberare tutti gli ECP e gli elenchi lookaside creati prima di scaricare.

Per altre informazioni sull'uso di elenchi lookaside con driver, vedere Using Lookaside Lists.

Fabbisogno

Requisito	Valore
client minimo supportato	La routine FsRtlInitExtraCreateParameterLookasideList è disponibile a partire da Windows Vista.
piattaforma di destinazione	Universale
intestazione	ntifs.h (include Ntifs.h)
libreria	NtosKrnl.lib
dll	NtosKrnl.exe
IRQL	<= APC_LEVEL