Funzione FsRtlInitExtraCreateParameterLookasideList (ntifs.h)

Articolo
08/07/2023

La routine FsRtlInitExtraCreateParameterLookasideList inizializza un elenco lookaside paged o nonpaged usato per l'allocazione di una o più strutture di contesto dei parametri di creazione 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 o NPAGED_LOOKASIDE_LIST struttura lookaside list-head. Per un elenco lookaside paginato o non a pagina, la struttura list-head deve essere allocata dal pool non a pagina.

[in] Flags

Definisce le opzioni di allocazione del pool. Se il parametro Flags contiene il valore del flag FSRTL_ECP_LOOKASIDE_FLAG_NONPAGED_POOL bit, FsRtlInitExtraCreateParameterLookasideList inizializza un elenco lookaside per voci ECP non impaginate delle dimensioni specificate. In caso contrario , FsRtlInitExtraCreateParameterLookasideList inizializza un elenco lookaside per le voci ECP impaginate 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 durante 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

Usare questa routine per inizializzare un elenco lookaside di pool impaginato o non a pagina. Usare 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.

Usare 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 Uso di Lookaside Elenchi.

Requisiti

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