Función FsRtlRemoveExtraCreateParameter (ntifs.h)

Artículo
02/29/2024

La rutina FsRtlRemoveExtraCreateParameter busca en una lista ECP una estructura de contexto ECP y, si se encuentra, la separa 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 del contexto ECP se desasocia correctamente de la lista especificada, este parámetro se establecerá para que apunte a la estructura de contexto ECP desasociada. Si la estructura del contexto ECP no se encuentra en la lista de ECP especificada, 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 la estructura de contexto ECP especificada no se encontró 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	La estructura de contexto ECP especificada no se encontró en la lista de ECP especificada.

Comentarios

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

Nota

FsRtlRemoveExtraCreateParameter no libera el grupo de memoria para la estructura del contexto ECP. Para liberar el grupo de memoria de 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	Value
Cliente mínimo compatible	La rutina FsRtlRemoveExtraCreateParameter 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