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 desde que o driver de minifiltro seja carregado.
[in, out] EcpList
O ponteiro para a estrutura de lista ECP à qual a estrutura de contexto ECP, fornecida pelo parâmetro EcpContext, deve ser adicionado.
[in, out] EcpContext
Ponteiro para a estrutura de contexto ECP a ser adicionada à lista ECP, fornecida pelo parâmetro EcpList.
Valor de retorno
FltInsertExtraCreateParameter retorna um dos seguintes valores NTSTATUS:
| Código de retorno | Descrição |
|---|---|
|
A estrutura de contexto ECP fornecida foi inserida com êxito na lista ECP fornecida. |
|
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. |
Observações
A rotina FltInsertExtraCreateParameter pressupõe que a estrutura de contexto ECP fornecida a ser inserida na lista 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 |
|---|---|
| de cliente com suporte mínimo | Essa rotina está disponível a partir do Windows Vista. |
| da Plataforma de Destino | Universal |
| cabeçalho | fltkernel.h (inclua Fltkernel.h) |
| biblioteca | FltMgr.lib |
| de DLL | Fltmgr.sys |
| IRQL | <= APC_LEVEL |
Consulte também
FltAllocateExtraCreateParameter
FltAllocateExtraCreateParameterFromLookasideList