Función FsRtlFindExtraCreateParameter (ntifs.h)

Artículo
12/21/2024

El FsRtlFindExtraCreateParameter rutina busca una lista de ECP determinada para una estructura de contexto ECP de un tipo determinado y devuelve un puntero a esta estructura si se encuentra.

Sintaxis

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

Parámetros

[in] EcpList

Puntero a la estructura de lista ECP que FsRtlFindExtraCreateParameter usa para buscar la estructura de contexto ECP, proporcionada por el parámetro EcpType.

[in] EcpType

Puntero a un GUID que identifica de forma única la estructura de contexto ecp. El rutina FsRtlFindExtraCreateParam ter usa este valor GUID para determinar si la estructura de contexto ecP existe en la lista ecP, proporcionada por el parámetro ecpList .

[out, optional] EcpContext

Parámetro opcional que recibe un puntero a la estructura de contexto ECP encontrada. Si no se encuentra la estructura de contexto ECP en la lista ECP, ecpContext se establece en NULL. Si ecpContext se establece en NULL por el autor de la llamada, el valor devuelto de FsRtlFindExtraCreateParamter se puede usar para determinar si la estructura de contexto ecP está en la lista ecP.

[out, optional] EcpContextSize

Parámetro opcional que recibe el tamaño, en bytes, de la estructura de contexto ECP encontrada. Si no se encuentra la estructura de contexto ECP, ecpContextSize se establece en cero.

Valor devuelto

FsRtlFindExtraCreateParameter devuelve uno de los siguientes valores NTSTATUS:

Código devuelto	Descripción
STATUS_SUCCESS	FsRtlFindExtraCreateParameter encontró la estructura de contexto ECP especificada en la lista ECP especificada.
STATUS_NOT_FOUND	FsRtlFindExtraCreateParameter no encontró la estructura de contexto ECP especificada en la lista ECP especificada.

Requisitos

Requisito	Valor
cliente mínimo admitido	La rutina FsRtlFindExtraCreateParameter está disponible a partir de Windows Vista.
de la plataforma de destino de	Universal
encabezado de	ntifs.h (incluya Ntifs.h)
biblioteca de	NtosKrnl.lib
DLL de	NtosKrnl.exe
irQL	<= APC_LEVEL