Función FsRtlRemoveExtraCreateParameter (ntifs.h)

Artículo
12/21/2024

La rutina FsRtlRemoveExtraCreateParameter busca una lista ecP para obtener una estructura de contexto ECP y, si se encuentra, la desasocia de la lista ecp.

Sintaxis

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

Parámetros

[in, out] EcpList

Puntero a la lista de parámetros de creación adicional (ECP) que contiene la estructura de contexto ECP que se va a desasociar de la lista especificada.

[in] EcpType

Puntero a un GUID que identifica de forma única la estructura de contexto ecp que se va a desasociar de la lista.

[out] EcpContext

Puntero a la estructura de contexto ECP desasociada. Si la estructura de contexto ECP se desasocia correctamente de la lista dada, este parámetro se establecerá para que apunte a la estructura de contexto de ECP desasociada. Si no se encuentra la estructura de contexto ECP en la lista ECP dada, este parámetro se establece en NULL.

[out, optional] EcpContextSize

Parámetro opcional que recibe el tamaño de la estructura de contexto ECP desasociada. Si este parámetro está presente cuando se llama a la rutina, el parámetro recibirá el tamaño, en bytes, de la estructura de contexto ECP desasociada. Si no se encontró la estructura de contexto ECP especificada en la lista de ECP especificada, este parámetro no está definido.

Valor devuelto

FsRtlRemoveExtraCreateParameter devuelve un código NTSTATUS como uno de los siguientes:

Código devuelto	Descripción
STATUS_SUCCESS	La estructura de contexto ECP dada se desasogró correctamente de la lista de ECP especificada.
STATUS_NOT_FOUND	No se encontró la estructura de contexto ECP especificada en la lista ecP especificada.

Observaciones

La rutina FsRtlRemoveExtraCreatePara meter busca en la lista ecP dada por el parámetro ecpList de para una estructura de contexto ECP dada por el parámetro EcpType. Si la estructura de contexto ECP existe en la lista, FsRtlRemoveExtraCreateParameter desasocia la estructura de la lista, establece el parámetro EcpContext para que apunte a la estructura y devuelva STATUS_SUCCESS. Si la estructura de contexto ECP no existe en la lista, FsRtlRemoveExtraCreateParameter establece el parámetro EcpContext para NULL y devuelve STATUS_NOT_FOUND.

Nota

FsRtlRemoveExtraCreateParameter no libera el grupo de memoria para la estructura de contexto ECP. Para liberar el grupo de memoria para la estructura de contexto ecp, primero llame a FsRtlRemoveExtraCreateParameter para separarlo de la lista y, a continuación, llame a la rutina FltFreeExtraCreateParameter para liberar el grupo de memoria para la estructura de contexto ecP.

Requisitos

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