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 destruido. 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.

Comentarios

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 FilterUnloadCallback del controlador de minifiltro (PFLT_FILTER_UNLOAD_CALLBACK).

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

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

Requisitos

Requisito	Value
Plataforma de destino	Universal
Encabezado	fltkernel.h (incluya Fltkernel.h)
Library	FltMgr.lib
Archivo DLL	Fltmgr.sys
IRQL	PASSIVE_LEVEL

Consulte también

FltLoadFilter

PFLT_FILTER_UNLOAD_CALLBACK

UNICODE_STRING