Función FsRtlInsertExtraCreateParameter (ntifs.h)

Artículo
12/21/2024

El FsRtlInsertExtraCreateParameter rutina inserta una estructura de contexto de parámetro de creación adicional (ECP) en una lista ecP.

Sintaxis

NTSTATUS FsRtlInsertExtraCreateParameter(
  [in, out] PECP_LIST EcpList,
  [in, out] PVOID     EcpContext
);

Parámetros

[in, out] EcpList

Puntero a la estructura de lista ECP a la que se debe agregar la estructura de contexto ECP, a la que apunta el parámetro EcpContext.

[in, out] EcpContext

Puntero a la estructura de contexto ecp que se va a agregar a la lista de ECP, a la que apunta el parámetro EcpList.

Valor devuelto

FsRtlInsertExtraCreateParameter devuelve uno de los siguientes valores NTSTATUS:

Código devuelto	Descripción
STATUS_SUCCESS	La estructura de contexto ECP especificada se insertó correctamente en la lista de ECP especificada.
STATUS_INVALID_PARAMETER	La estructura de contexto ECP dada ya existe en la lista de ECP especificada. En el contexto de la inserción de listas ECP, se considera que dos estructuras de contexto ECP son idénticas si contienen valores GUID iguales.

Observaciones

La rutina FsRtlInsertExtraCreateParameter supone que la estructura de contexto ECP especificada que se va a insertar en la lista ecP especificada se asignó previamente mediante la rutina FltAllocateExtraCreateParameter.

Cada estructura de contexto ECP insertada en la lista ECP debe tener un valor GUID único. Este valor único se establece cuando la rutina de FltAllocateExtraCreateParameter asigna la estructura de contexto ECP.

Requisitos

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