Función FltOpenVolume (fltkernel.h)

La rutina FltOpenVol ume devuelve un identificador y un puntero de objeto de archivo para el volumen del sistema de archivos al que está asociada una instancia de controlador de minifiltro determinada.

Sintaxis

NTSTATUS FLTAPI FltOpenVolume(
  [in]  PFLT_INSTANCE Instance,
  [out] PHANDLE       VolumeHandle,
  [out] PFILE_OBJECT  *VolumeFileObject
);

Parámetros

[in] Instance

Puntero de instancia opaco para la instancia. Esta instancia debe adjuntarse a un volumen local.

[out] VolumeHandle

Identificador del volumen del sistema de archivos.

[out] VolumeFileObject

Puntero a una variable asignada por el autor de la llamada que recibe un puntero de objeto de archivo para el directorio raíz del volumen. Este parámetro es opcional y se puede NULL.

Valor devuelto

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

Observaciones

Cuando el controlador devuelto en el parámetro VolumeHandle ya no es necesario, el autor de la llamada debe liberarlo llamando a FltClose. Por lo tanto, todas las llamadas correctas a FltOpenVolume deben coincidir con una llamada posterior a FltClose.

Si se devuelve un puntero de objeto de archivo en el parámetro VolumeFileObject, el autor de la llamada debe liberarlo cuando ya no lo necesite llamando a ObDereferenceObject.

La instancia especificada por el parámetro Instance debe adjuntarse a un volumen local. Si está conectado a un volumen de red, FltOpenVolume devuelve STATUS_INVALID_PARAMETER.

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.

NOTA: No llame a esta rutina con un valor IRP de nivel superior distinto de NULL, ya que esto puede provocar un interbloqueo del sistema. Para determinar si el subproceso TopLevelIrp se establece la llamada IoGetTopLevelIrp.

Requisitos

Consulte también

fltClose

FltGetDeviceObject

FltGetFilterFromInstance

FltObjectDereference

FltQueryVolumeInformation

obDereferenceObject