Funzione FsRtlInsertExtraCreateParameter (ntifs.h)

Articolo
12/21/2024

La routine FsRtlInsertExtraCreateParameter inserisce una struttura di contesto ECP (Create Parameter) aggiuntiva in un elenco ECP.

Sintassi

NTSTATUS FsRtlInsertExtraCreateParameter(
  [in, out] PECP_LIST EcpList,
  [in, out] PVOID     EcpContext
);

Parametri

[in, out] EcpList

Puntatore alla struttura di elenco ECP a cui deve essere aggiunta la struttura del contesto ECP, a cui punta il parametro EcpContext .

[in, out] EcpContext

Puntatore alla struttura del contesto ECP da aggiungere all'elenco ECP, a cui punta il parametro EcpList .

Valore restituito

FsRtlInsertExtraCreateParameter restituisce uno dei valori NTSTATUS seguenti:

Codice restituito	Descrizione
STATUS_SUCCESS	La struttura del contesto ECP specificata è stata inserita correttamente nell'elenco ECP specificato.
STATUS_INVALID_PARAMETER	La struttura di contesto ECP specificata esiste già nell'elenco ECP specificato. Nel contesto dell'inserimento dell'elenco ECP, due strutture di contesto ECP vengono considerate identiche se contengono valori GUID uguali.

Osservazioni

La routine FsRtlInsertExtraCreateParameter presuppone che la struttura di contesto ECP specificata venga inserita nell'elenco ECP specificato sia stata precedentemente allocata dalla routine FltAllocateExtraCreateParameter.

Ogni struttura di contesto ECP inserita nell'elenco ECP deve avere un valore GUID univoco. Questo valore univoco viene impostato quando la struttura del contesto ECP viene allocata dalla routine FltAllocateExtraCreateParameter.

Fabbisogno

Requisito	Valore
client minimo supportato	La routine FltInsertExtraCreateParameter è 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