Compartilhar via


Função FltInsertExtraCreateParameter (fltkernel.h)

A rotina FltInsertExtraCreateParameter insere uma estrutura de contexto ECP (parâmetro de criação extra) em uma lista ECP.

Sintaxe

NTSTATUS FLTAPI FltInsertExtraCreateParameter(
  [in]      PFLT_FILTER Filter,
  [in, out] PECP_LIST   EcpList,
  [in, out] PVOID       EcpContext
);

Parâmetros

[in] Filter

Ponteiro de filtro opaco para o driver de minifiltro. Esse ponteiro identifica exclusivamente o driver de minifiltro e permanece constante enquanto o driver de minifiltro é carregado.

[in, out] EcpList

Ponteiro para a estrutura de lista ECP à qual a estrutura de contexto ECP, fornecida pelo parâmetro EcpContext , deve ser adicionada.

[in, out] EcpContext

Ponteiro para a estrutura de contexto ECP a ser adicionada à lista ECP, fornecida pelo parâmetro EcpList .

Retornar valor

FltInsertExtraCreateParameter retorna um dos seguintes valores NTSTATUS:

Código de retorno Descrição
STATUS_SUCCESS
A estrutura de contexto ECP fornecida foi inserida com êxito na lista ECP fornecida.
STATUS_INVALID_PARAMETER
A estrutura de contexto ECP fornecida já existe na lista ECP fornecida. No contexto de inserção de lista ECP, duas estruturas de contexto ECP são consideradas idênticas se contiverem valores guid iguais.

Comentários

A rotina FltInsertExtraCreateParameter pressupõe que a estrutura de contexto ECP fornecida a ser inserida na lista de ECP fornecida foi alocada anteriormente pela rotina FltAllocateExtraCreateParameter .

Cada estrutura de contexto ECP inserida na lista ECP deve ter um valor GUID exclusivo. Esse valor exclusivo é definido quando a estrutura de contexto ECP é alocada pela rotina FltAllocateExtraCreateParameter .

Requisitos

Requisito Valor
Cliente mínimo com suporte Essa rotina está disponível a partir do Windows Vista.
Plataforma de Destino Universal
Cabeçalho fltkernel.h (inclua Fltkernel.h)
Biblioteca FltMgr.lib
DLL Fltmgr.sys
IRQL <= APC_LEVEL

Confira também

ECP_LIST

FltAllocateExtraCreateParameter

FltAllocateExtraCreateParameterFromLookasideList

FltAllocateExtraCreateParameterList

FltCreateFileEx2

FltFreeExtraCreateParameter

FltGetEcpListFromCallbackData

FltRemoveExtraCreateParameter

FltSetEcpListIntoCallbackData

IoCreateFileEx