Condividi tramite


Funzione FltFindExtraCreateParameter (fltkernel.h)

La routine FltFindExtraCreateParameter cerca un elenco ECP specificato per una struttura di contesto ECP di un determinato tipo e restituisce un puntatore a questa struttura se viene trovato.

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 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] EcpList

Puntatore alla struttura di elenco ECP in cui cercare la struttura del contesto ECP (specificata dal parametro EcpType ).

[in] EcpType

Puntatore a un GUID che identifica in modo univoco ogni struttura di contesto ECP. Questo valore GUID viene usato dalla routine FltFindExtraCreateParamter per determinare se la struttura del contesto ECP esiste nell'elenco ECP (dato 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, il valore restituito di questa routine può essere usato 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 ).

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
DLL Fltmgr.sys
IRQL <= APC_LEVEL

Vedi anche

ECP_LIST

FltAllocateExtraCreateParameterFromLookasideList

FltCreateFileEx2

FltFreeExtraCreateParameter

FltGetEcpListFromCallbackData

FltInsertExtraCreateParameter

FltRemoveExtraCreateParameter

FltSetEcpListIntoCallbackData

IoCreateFileEx