Condividi tramite


Funzione FltFindExtraCreateParameter (fltkernel.h)

La routine FltFindExtraCreateParameter cerca in un determinato elenco ECP una struttura di contesto ECP di un determinato tipo e restituisce un puntatore a questa struttura, se presente.

Sintassi

NTSTATUS FLTAPI FltFindExtraCreateParameter(
  [in]            PFLT_FILTER Filter,
  [in]            PECP_LIST   EcpList,
  [in]            LPCGUID     EcpType,
  [out, optional] PVOID       *EcpContext,
  [out, optional] ULONG       *EcpContextSize
);

Parametri

[in] Filter

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

[in] EcpList

Puntatore alla struttura dell'elenco ECP in cui cercare la struttura del contesto ECP (in base al parametro EcpType).

[in] EcpType

Puntatore a un GUID che identifica in modo univoco ogni struttura di contesto ECP. Questo valore GUID viene utilizzato dalla routine FltFindExtraCreateParamter per determinare se la struttura del contesto ECP esiste nell'elenco ECP (data dal parametro EcpList).

[out, optional] EcpContext

Parametro facoltativo che riceve un puntatore alla struttura di contesto ECP trovata. Se la struttura del contesto ECP non viene trovata nell'elenco ECP, EcpContext è impostata su NULL. Se EcpContext è impostato su NULL dal chiamante, è possibile utilizzare il valore restituito di questa routine per determinare se la struttura del contesto ECP si trova nell'elenco ECP.

[out, optional] EcpContextSize

Parametro facoltativo che riceve le dimensioni, in byte, della struttura di contesto ECP trovata. Se la struttura del contesto ECP non viene trovata nell'elenco ECP, EcpContextSize è impostata su zero.

Valore restituito

FltFindExtraCreateParameter restituisce uno dei valori NTSTATUS seguenti:

Codice restituito Descrizione
STATUS_SUCCESS
La struttura del contesto ECP (come specificato dal parametro EcpType) è stata trovata nell'elenco ECP (come specificato dal parametro EcpList).
STATUS_NOT_FOUND
La struttura del contesto ECP (come specificato dal parametro EcpType) non è stata trovata nell'elenco ECP (come specificato dal parametro EcpList).

Fabbisogno

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

Vedere anche

ECP_LIST

FltAllocateExtraCreateParameterFromLookasideList

FltCreateFileEx2

FltFreeExtraCreateParameter

FltGetEcpListFromCallbackData

FltInsertExtraCreateParameter

FltRemoveExtraCreateParameter

FltSetEcpListIntoCallbackData

IoCreateFileEx