Función FsRtlRemoveExtraCreateParameter (ntifs.h)
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 |
Consulte también
FsRtlAllocateExtraCreateParameter