Função FsRtlFindExtraCreateParameter (ntifs.h)

Artigo
08/07/2023

A rotina FsRtlFindExtraCreateParameter pesquisa uma determinada lista de ECP em busca de 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 do 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.

Retornar valor

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