Función FltUnloadFilter (fltkernel.h)

  • Artículo

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