Função FsRtlRemoveExtraCreateParameter (ntifs.h)

Artigo
02/29/2024

A rotina FsRtlRemoveExtraCreateParameter pesquisa uma lista de ECP em busca de uma estrutura de contexto ECP e, se encontrada, a desanexa da lista ECP.

Sintaxe

NTSTATUS FsRtlRemoveExtraCreateParameter(
  [in, out]       PECP_LIST EcpList,
  [in]            LPCGUID   EcpType,
  [out]           PVOID     *EcpContext,
  [out, optional] ULONG     *EcpContextSize
);

Parâmetros

[in, out] EcpList

Ponteiro para a lista de parâmetros de criação extra (ECP) que contém a estrutura de contexto ECP a ser desanexada da lista fornecida.

[in] EcpType

Ponteiro para um GUID que identifica exclusivamente a estrutura de contexto ECP a ser desanexada da lista.

[out] EcpContext

Ponteiro para a estrutura de contexto ECP desanexada. Se a estrutura de contexto ECP for desanexada com êxito da lista fornecida, esse parâmetro será definido para apontar para a estrutura de contexto ECP desanexada. Se a estrutura de contexto ECP não for encontrada na lista ECP fornecida, esse parâmetro será definido como NULL.

[out, optional] EcpContextSize

Parâmetro opcional que recebe o tamanho da estrutura de contexto ECP desanexada. Se esse parâmetro estiver presente quando a rotina for chamada, o parâmetro receberá o tamanho, em bytes, da estrutura de contexto ECP desanexada. Se a estrutura de contexto ECP fornecida não foi encontrada na lista de ECP fornecida, esse parâmetro é indefinido.

Retornar valor

FsRtlRemoveExtraCreateParameter retorna um código NTSTATUS, como um dos seguintes:

Código de retorno	Descrição
STATUS_SUCCESS	A estrutura de contexto ECP fornecida foi desanexada com êxito da lista ECP fornecida.
STATUS_NOT_FOUND	A estrutura de contexto ECP fornecida não foi encontrada na lista de ECP fornecida.

Comentários

A rotina FsRtlRemoveExtraCreateParameter pesquisa a lista ECP fornecida pelo parâmetro EcpList para uma estrutura de contexto ECP fornecida pelo parâmetro EcpType . Se a estrutura de contexto ECP existir na lista, FsRtlRemoveExtraCreateParameter desanexará a estrutura da lista, definirá o parâmetro EcpContext para apontar para a estrutura e retornará STATUS_SUCCESS. Se a estrutura de contexto ECP não existir na lista, FsRtlRemoveExtraCreateParameter definirá o parâmetro EcpContext como NULL e retornará STATUS_NOT_FOUND.

Observação

FsRtlRemoveExtraCreateParameter não libera o pool de memória para a estrutura de contexto ECP. Para liberar o pool de memória para a estrutura de contexto ECP, primeiro chame FsRtlRemoveExtraCreateParameter para desanexá-lo da lista e, em seguida, chame a rotina FltFreeExtraCreateParameter para liberar o pool de memória para a estrutura de contexto ECP.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	A rotina FsRtlRemoveExtraCreateParameter 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