Função FsRtlInsertExtraCreateParameter (ntifs.h)

Artigo
02/26/2024

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

Sintaxe

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

Parâmetros

[in, out] EcpList

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

[in, out] EcpContext

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

Retornar valor

FsRtlInsertExtraCreateParameter 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 FsRtlInsertExtraCreateParameter 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
Cliente mínimo com suporte	A rotina FltInsertExtraCreateParameter está disponível a partir do Windows Vista.
Plataforma de Destino	Universal
Cabeçalho	ntifs.h (inclua Ntifs.h)
Biblioteca	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL