Función FltUnloadFilter (fltkernel.h)

Un controlador de minifiltro que ha cargado un controlador de minifiltro auxiliar llamando a FltLoadFilter puede descargar el controlador de minifiltro llamando a FltUnloadFilter.

Sintaxis

NTSTATUS FLTAPI FltUnloadFilter(
  [in] PCUNICODE_STRING FilterName
);

Parámetros

[in] FilterName

Puntero a una estructura de UNICODE_STRING que contiene el nombre del servicio del controlador de minifiltro que se pasó a FltLoadFilter.

Valor devuelto

fltUnloadFilter devuelve STATUS_SUCCESS o un valor NTSTATUS adecuado, como uno de los siguientes:

Código devuelto	Descripción
STATUS_FLT_DELETING_OBJECT	Se encontró un controlador de minifiltro coincidente, pero ya está siendo derribado. Se trata de un código de error.
STATUS_FLT_FILTER_NOT_FOUND	No se encontró ningún controlador de minifiltro coincidente. Se trata de un código de error.

Observaciones

Un controlador de minifiltro que tiene una dependencia en otro controlador de minifiltro puede descargar ese controlador de minifiltro llamando a FltUnloadFilter. Esta rutina busca un controlador de minifiltro registrado cuyo nombre de servicio coincida con el FilterName especificado y llama a la rutina del controlador de minifiltro FilterUnloadCallback (PFLT_FILTER_UNLOAD_CALLBACK).

Si el controlador de minifiltro auxiliar no registró una rutina de FilterUnloadCallback, se produce un error en la llamada a FltUnloadFilter.

Un controlador de minifiltro no puede llamar a FltUnloadFilter para descargarse.

Requisitos

Requisito	Valor
de la plataforma de destino de	Universal
encabezado de	fltkernel.h (incluya Fltkernel.h)
biblioteca de	FltMgr.lib
DLL de	Fltmgr.sys
irQL	PASSIVE_LEVEL

Consulte también

FltLoadFilter

PFLT_FILTER_UNLOAD_CALLBACK

UNICODE_STRING