Función FsRtlGetNextExtraCreateParameter (ntifs.h)

Artículo
12/20/2024

La rutina FsRtlGetNextExtraCreateParameter devuelve un puntero a la siguiente estructura de contexto de creación adicional (o primero) del parámetro de creación (ECP) en una lista de ECP determinada.

Sintaxis

NTSTATUS FsRtlGetNextExtraCreateParameter(
  [in]            PECP_LIST EcpList,
  [in, optional]  PVOID     CurrentEcpContext,
  [out, optional] LPGUID    NextEcpType,
  [out]           PVOID     *NextEcpContext,
  [out, optional] ULONG     *NextEcpContextSize
);

Parámetros

[in] EcpList

Puntero a la lista ECP que se va a examinar.

[in, optional] CurrentEcpContext

Puntero opcional a una estructura de contexto ECP en la lista de ECP especificada. Si está presente, FsRtlGetNextExtraCreateParameter devuelve un puntero al ECP después de la estructura de contexto currentEcpContext CurrentEcpContext ECP. Si CurrentEcpContext es null, FsRtlGetNextExtraCreateParameter devuelve la primera estructura de contexto ECP de la lista.

[out, optional] NextEcpType

Parámetro opcional que recibe un puntero al GUID de la estructura de contexto ECP devuelta.

[out] NextEcpContext

Parámetro opcional que recibe un puntero a la estructura de contexto ECP devuelta.

[out, optional] NextEcpContextSize

Parámetro opcional que recibe el tamaño, en bytes, de la estructura de contexto ECP devuelta.

Valor devuelto

FsRtlGetNextExtraCreateParameter devuelve uno de los siguientes valores NTSTATUS:

Código devuelto	Descripción
STATUS_SUCCESS	FsRtlGetNextExtraCreateParameter encontró una estructura de contexto ECP en la lista ecpList ECP de .
STATUS_NOT_FOUND	La ecpList lista ECP está vacía o CurrentEcpContext es el último ECP de la lista (es decir, no hay ningún elemento de lista ECP siguiente). Además, NextEcpContext se establece en NULL y NextEcpContextSize está establecido en cero.
STATUS_INVALID_PARAMETER	El parámetro ecpList de es NULL.

Observaciones

La rutinaFsRtlGetNextExtraCreateParameter procesa una lista ecP de forma no circular. Es decir, si la estructura de contexto ECP a la que apunta el parámetro CurrentEcpContext es el último elemento de la lista ECP, no hay ningún ECP "siguiente" en la lista y la rutina devuelve STATUS_NOT_FOUND.

Requisitos

Requisito	Valor
cliente mínimo admitido	La rutina FsRtlGetNextExtraCreateParameter 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