Función FsRtlFindExtraCreateParameter (ntifs.h)

Artículo
08/07/2023

La rutina FsRtlFindExtraCreateParameter busca en una lista de ECP determinada 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. La rutina FsRtlFindExtraCreateParamter usa este valor GUID para determinar si la estructura del 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 la estructura del contexto ECP no se encuentra en la lista ECP, EcpContext se establece en NULL. Si EcpContext se establece en NULL por el autor de la llamada, se puede usar el valor devuelto de FsRtlFindExtraCreateParamter 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 de ECP especificada.

Requisitos

Requisito	Value
Cliente mínimo compatible	La rutina FsRtlFindExtraCreateParameter está disponible a partir de Windows Vista.
Plataforma de destino	Universal
Encabezado	ntifs.h (incluya Ntifs.h)
Library	NtosKrnl.lib
Archivo DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL