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 obligatorio y no puede ser NULL.

Valor devuelto

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

Comentarios

FltGetVolumeFromInstance agrega una referencia de rundown al puntero de volumen opaco devuelto en el parámetro RetVolume . 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 de un volumen determinado, llame a FltGetDeviceObject.

Para obtener información detallada sobre el volumen al que está asociada una instancia determinada, llame a FltQueryVolumeInformation.

Requisitos

Consulte también

FltGetDeviceObject

FltGetFilterFromInstance

FltObjectDereference

FltQueryVolumeInformation