Función FltGetFilterFromInstance (fltkernel.h)

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

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 necesario y no se puede null.

Valor devuelto

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

Observaciones

FltGetFilterFromInstance agrega una referencia de rundown al puntero de filtro opaco devuelto en el parámetro RetFilter de. 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 se adjunta 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.

Requisitos

Consulte también

FltEnumerateInstanceInformationByFilter

fltEnumerateInstances

FltGetVolumeFromInstance

FltObjectDereference