Función FltLoadFilter (fltkernel.h)

  • Artículo

La rutina FltLoadFilter carga dinámicamente un controlador de minifiltro en el sistema que se está ejecutando actualmente.

Sintaxis

NTSTATUS FLTAPI FltLoadFilter(
  [in] PCUNICODE_STRING FilterName
);

Parámetros

[in] FilterName

Puntero a una estructura de UNICODE_STRING que contiene el nombre del servicio para el controlador de minifiltro.

Valor devuelto

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

Código devuelto Descripción
STATUS_DRIVER_FAILED_PRIOR_UNLOAD
 No se pudo cargar el controlador de minifiltro porque una versión anterior del controlador todavía está en memoria. Se trata de un código de error.
STATUS_FAILED_DRIVER_ENTRY
 La rutina DriverEntry del controlador minifiltro devolvió un valor NTSTATUS que no era un código correcto. Se trata de un código de error.
STATUS_IMAGE_ALREADY_LOADED
 El controlador minifiltro ya está en ejecución. Se trata de un código de error.
STATUS_OBJECT_NAME_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 cargar ese controlador de minifiltro llamando a FltLoadFilter.

Para descargar el controlador de minifiltro auxiliar, llame a FltUnloadFilter.

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

FltUnloadFilter

UNICODE_STRING