Nota
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
La rutina de FltGetVolumeFromFileObject devuelve un puntero opaco para el volumen en el que reside una secuencia de archivos determinada.
Sintaxis
NTSTATUS FLTAPI FltGetVolumeFromFileObject(
[in] PFLT_FILTER Filter,
[in] PFILE_OBJECT FileObject,
[out] PFLT_VOLUME *RetVolume
);
Parámetros
[in] Filter
Puntero de filtro opaco para el autor de la llamada. Este parámetro es necesario y no se puede null.
[in] FileObject
Puntero de objeto de archivo para una secuencia de archivos que reside en el volumen.
[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
FltGetVolumeFromFileObject devuelve STATUS_SUCCESS o un valor NTSTATUS adecuado, como uno de los siguientes:
Código devuelto | Descripción |
---|---|
|
El volumen se está descomponiéndose. Se trata de un código de error. |
|
No se encontró ningún volumen coincidente. Se trata de un código de error. |
Observaciones
FltGetVolumeFromFileObject 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, todas las llamadas correctas a FltGetVolumeFromFileObject deben coincidir con una llamada posterior a FltObjectDereference.
Para obtener un puntero al objeto de dispositivo para un volumen determinado, llame a FltGetDeviceObject.
Requisitos
Requisito | Valor |
---|---|
de la plataforma de destino de | Universal |
encabezado de | fltkernel.h (incluya Fltkernel.h) |
biblioteca de | FltMgr.lib |
DLL de | Fltmgr.sys |
irQL | <= APC_LEVEL |