Función FltGetVolumeFromInstance (fltkernel.h)

La rutina FltGetVolumeFromInstance devuelve un puntero opaco para el volumen al que está asociada una instancia de controlador de minifiltro determinada.

Sintaxis

NTSTATUS FLTAPI FltGetVolumeFromInstance(
  [in]  PFLT_INSTANCE Instance,
  [out] PFLT_VOLUME   *RetVolume
);

Parámetros

[in] Instance

Puntero de instancia opaco para la instancia.

[out] RetVolume

Puntero a una variable asignada por el autor de la llamada que recibe un puntero opaco para el volumen. Este parámetro es necesario y no se puede null.

Valor devuelto

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

Observaciones

FltGetVolumeFromInstance agrega una referencia de rundown al puntero de volumen opaco devuelto en el parámetro retVolume 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 fltGetVolumeFromInstance debe coincidir con una llamada posterior a FltObjectDereference.

Para obtener un puntero de filtro opaco para el controlador de minifiltro que creó una instancia determinada, llame a FltGetFilterFromInstance.

Para obtener un puntero al objeto de dispositivo para un volumen determinado, llame a FltGetDeviceObject.

Para obtener información detallada sobre el volumen al que se adjunta una instancia determinada, llame a FltQueryVolumeInformation.

Requisitos

Consulte también

FltGetDeviceObject

FltGetFilterFromInstance

FltObjectDereference

FltQueryVolumeInformation