Función FltGetFilterFromInstance (fltkernel.h)

Artículo
02/29/2024

La rutina FltGetFilterFromInstance devuelve un puntero de filtro opaco para el controlador de minifiltro que creó la instancia especificada.

Sintaxis

NTSTATUS FLTAPI FltGetFilterFromInstance(
  [in]  PFLT_INSTANCE Instance,
  [out] PFLT_FILTER   *RetFilter
);

Parámetros

[in] Instance

Puntero de instancia opaco para la instancia.

[out] RetFilter

Puntero a una variable asignada por el autor de la llamada que recibe un puntero de filtro opaco para el controlador de minifiltro. Este parámetro es obligatorio y no puede ser NULL.

Valor devuelto

FltGetFilterFromInstance devuelve STATUS_SUCCESS o un valor NTSTATUS adecuado, como el siguiente:

Código devuelto	Descripción
STATUS_FLT_DELETING_OBJECT	El controlador de minifiltro se está descomponendo. Se trata de un código de error.

Comentarios

FltGetFilterFromInstance agrega una referencia de resumen al puntero de filtro opaco devuelto en el parámetro RetFilter . Cuando este puntero ya no es necesario, el autor de la llamada debe liberarlo llamando a FltObjectDereference. Por lo tanto, cada llamada correcta a FltGetFilterFromInstance debe coincidir con una llamada posterior a FltObjectDereference.

Para obtener un puntero de volumen opaco para el volumen al que está asociada una instancia de controlador de minifiltro determinada, llame a FltGetVolumeFromInstance.

Para enumerar todas las instancias de un controlador de minifiltro determinado, llame a FltEnumerateInstanceInformationByFilter.

Para enumerar instancias de todos los controladores de minifiltro en todos los volúmenes, llame a FltEnumerateInstances.