Função FsRtlFindExtraCreateParameter (ntifs.h)

Artigo
12/21/2024

A rotina FsRtlFindExtraCreateParameter pesquisa uma determinada lista ECP para uma estrutura de contexto ECP de um determinado tipo e retorna um ponteiro para essa estrutura se ela for encontrada.

Sintaxe

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

Parâmetros

[in] EcpList

Ponteiro para a estrutura de lista ECP que FsRtlFindExtraCreateParameter usa para pesquisar a estrutura de contexto ECP, fornecida pelo parâmetro EcpType .

[in] EcpType

Ponteiro para um GUID que identifica exclusivamente a estrutura de contexto ECP. Esse valor GUID é usado pela rotina FsRtlFindExtraCreateParamter para determinar se a estrutura de contexto ECP existe na lista ECP, fornecida pelo parâmetro EcpList .

[out, optional] EcpContext

Parâmetro opcional que recebe um ponteiro para a estrutura de contexto ECP encontrada. Se a estrutura de contexto ECP não for encontrada na lista ECP, EcpContext será definido como NULL. Se EcpContext for definido como NULL pelo chamador, o valor retornado de FsRtlFindExtraCreateParamter poderá ser usado para determinar se a estrutura de contexto ECP está na lista ECP.

[out, optional] EcpContextSize

Parâmetro opcional que recebe o tamanho, em bytes, da estrutura de contexto ECP encontrada. Se a estrutura de contexto ECP não for encontrada, EcpContextSize será definido como zero.

Valor de retorno

FsRtlFindExtraCreateParameter retorna um dos seguintes valores NTSTATUS:

Código de retorno	Descrição
STATUS_SUCCESS	FsRtlFindExtraCreateParameter encontrou a estrutura de contexto ECP especificada na lista ECP especificada.
STATUS_NOT_FOUND	FsRtlFindExtraCreateParameter não encontrou a estrutura de contexto ECP especificada na lista ECP especificada.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	A rotina FsRtlFindExtraCreateParameter está disponível a partir do Windows Vista.
da Plataforma de Destino	Universal
cabeçalho	ntifs.h (inclua Ntifs.h)
biblioteca	NtosKrnl.lib
de DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL

Consulte também

ECP_LIST

FltAllocateExtraCreateParameterFromLookasideList

FltCreateFileEx2

FltFreeExtraCreateParameter

FltGetEcpListFromCallbackData

FltInsertExtraCreateParameter

FltRemoveExtraCreateParameter

FltSetEcpListIntoCallbackData

IoCreateFileEx

Compartilhar via