Funzione FltAllocateExtraCreateParameterList (fltkernel.h)

Articolo
08/07/2023

La routine FltAllocateExtraCreateParameterList alloca la memoria del pool impaginata per una struttura di elenco di parametri di creazione aggiuntiva (ECP) e genera un puntatore a tale struttura.

Sintassi

NTSTATUS FLTAPI FltAllocateExtraCreateParameterList(
  [in]  PFLT_FILTER                  Filter,
  [in]  FSRTL_ALLOCATE_ECPLIST_FLAGS Flags,
  [out] PECP_LIST                    *EcpList
);

Parametri

[in] Filter

Puntatore filtro opaco per il driver minifilter. Questo puntatore identifica in modo univoco il driver minifilter e rimane costante finché viene caricato il driver minifilter.

[in] Flags

Definisce le opzioni di allocazione del pool. Se il flag FSRTL_ALLOCATE_ECPLIST_FLAG_CHARGE_QUOTA viene combinato con il parametro Flags usando un'operazione OR bit per bit, qualsiasi pool allocato dalla routine verrà addebitato sulla quota di memoria del processo corrente.

[out] EcpList

Riceve un puntatore a una struttura di elenco ECP inizializzata. Se la routine non è riuscita a allocare un pool sufficiente, *EcpList sarà NULL e la routine restituirà il codice di stato STATUS_INSUFFICIENT_RESOURCES.

Valore restituito

FltAllocateExtraCreateParameterList può restituire uno dei valori seguenti:

Codice restituito	Descrizione
STATUS_INSUFFICIENT_RESOURCES	FltAllocateExtraCreateParameterList non è stato in grado di allocare memoria sufficiente per una struttura di elenco ECP. In questo caso , EcpList* sarà NULL.
STATUS_SUCCESS	La struttura dell'elenco ECP è stata allocata e inizializzata correttamente. In questo caso, viene restituito un puntatore alla struttura dell'elenco inizializzato nel parametro *EcpList .

Commenti

Se il sistema operativo libera automaticamente la memoria che FltAllocateExtraCreateParameterList dipende dal momento in cui fltAllocateExtraCreateParameterList viene chiamato, come illustrato nelle situazioni seguenti:

Un chiamante può richiamare FltAllocateExtraCreateParameterList per allocare la ECP_LIST e aggiungere una o più strutture di contesto ECP prima che il chiamante richiama la routine FltCreateFileEx2 . In questa situazione, il sistema operativo non libera alcuna delle strutture di contesto ECP. Pertanto, il chiamante può effettuare più chiamate a FltCreateFileEx2 con lo stesso set ECP. Quando il chiamante viene eseguito con il ECP_LIST, il chiamante deve chiamare la routine FltFreeExtraCreateParameterList per liberare il ECP_LIST.
Mentre un driver di filtro del file system elabora una richiesta di IRP_MJ_CREATE , il driver di filtro del file system può chiamare FltInsertExtraCreateParameter per collegare un ECP a un ECP_LIST esistente. Se la ECP_LIST non esiste, il chiamante deve chiamare FltAllocateExtraCreateParameterList per creare la ECP_LIST. In questa situazione, la ECP_LIST e la struttura del contesto ECP vengono automaticamente puliti dal gestore di I/O al termine dell'operazione di creazione. Ciò consente a un driver di filtro di propagarsi correttamente attraverso l'elaborazione di punti di ripristino. Questo processo potrebbe richiedere la generazione di più richieste di IRP_MJ_CREATE.

Se il flag FSRTL_ALLOCATE_ECPLIST_FLAG_CHARGE_QUOTA viene usato con il parametro Flags , come descritto in precedenza, viene allocato un normale pool di pagine. In caso contrario, un pool paginabile viene allocato usando un elenco lookaside interno.

ECP_LIST struttura

ECP_LIST è una struttura opaca dichiarata dal sistema operativo. ECP_LIST contiene un elenco di voci di parametri di creazione aggiuntivi (ECP).

La routine FltAllocateExtraCreateParameterList deve essere usata per allocare memoria per la struttura di ECP_LIST . La memoria allocata da FltAllocateExtraCreateParameterList non viene liberata automaticamente dal sistema operativo; deve essere deallocata in modo esplicito chiamando la routine FltFreeExtraCreateParameterList . Si noti che tutti gli elementi di elenco ECP rimanenti verranno liberati automaticamente quando viene chiamato FltFreeExtraCreateParameterList .

Il tipo di dati PECP_LIST viene usato per dichiarare un puntatore a una variabile di tipo ECP_LIST.

Sintassi

struct ECP_LIST {
  ;      // Reserved.
};

La struttura ECP_LIST è dichiarata in Ntifs.h (include Ntifs.h).

Requisiti

Requisito	Valore
Client minimo supportato	Questa routine è disponibile a partire da Windows Vista.
Piattaforma di destinazione	Universale
Intestazione	fltkernel.h (includere Fltkernel.h)
Libreria	FltMgr.lib
IRQL	<= APC_LEVEL