FSCTL_QUERY_FILE_REGIONS IOCTL (ntifs.h)
FSCTL_QUERY_FILE_REGIONS consulta una lista de regiones de archivo, en función de un parámetro de uso especificado, para el archivo asociado al identificador en el que se invocó este FSCTL. Este mensaje contiene un elemento de datos opcional FILE_REGION_INPUT. Si no se especifica ningún parámetro FILE_REGION_INPUT, se devuelve información para todo el tamaño del archivo.
Código principal
FSCTL_QUERY_FILE_REGIONS
Búfer de entrada
Puntero a una estructura de FILE_REGION_INPUT que indica las regiones de archivo que se van a consultar.
Longitud del búfer de entrada
Tamaño de la estructura de FILE_REGION_INPUT que inputBuffer apunta, en bytes.
Búfer de salida
Puntero a una estructura FILE_REGION_OUTPUT en la que se devuelven los resultados de la consulta.
Longitud del búfer de salida
Tamaño del búfer al que outputBuffer apunta, en bytes.
Búfer de entrada y salida
n/a
Longitud del búfer de entrada y salida
n/a
Bloque de estado
Reservado para uso del sistema.
Observaciones
Para realizar esta operación, llame a FltFsControlFile o ZwFsControlFile con los parámetros siguientes.
| Parámetro | Descripción |
|---|---|
| instancia de | [in] Solo para FltFsControlFile. Puntero de instancia opaco para el autor de la llamada. Este parámetro es necesario y no puede ser NULL. |
| FileObject de |
[in] Solo para FltFsControlFile. Puntero de objeto de archivo para el archivo o directorio que es el destino de esta solicitud. Este parámetro es necesario y no puede ser NULL. |
| FileHandle de |
[in] Solo para ZwFsControlFile. Identificador de archivo del archivo o directorio que es el destino de esta solicitud. Este parámetro es necesario y no puede ser NULL. |
| |
[out] Solo para ZwFsControlFile. Puntero a una estructura IO_STATUS_BLOCK en la que se devuelve el estado final de la solicitud. |
| FsControlCode | [in] Establezca en FSCTL_QUERY_FILE_REGIONS. |
| InputBuffer | [in/optional] Puntero a una estructura de FILE_REGION_INPUT que indica las regiones de archivo que se van a consultar. |
| InputBufferLength | [in] Tamaño del búfer al que apunta InputBuffer, en bytes. |
| OutputBuffer | [out] Puntero a una estructura FILE_REGION_OUTPUT en la que se devuelven los resultados de la consulta. |
| OutputBufferLength | [out] Tamaño del búfer al que outputBuffer apunta, en bytes. |
| LengthReturned | [out] Puntero a una variable asignada por el autor de la llamada que recibe el tamaño en bytes de la información devuelta en el búfer en OutputBuffer. |
Valores devueltos
FSCTL_QUERY_FILE_REGIONS devuelve STATUS_SUCCESS tras la finalización correcta; de lo contrario, devuelve un código de error. Al finalizar correctamente, el autor de la llamada debe comprobar primero que ioStatus.Information sea mayor o igual que LengthReturned antes de acceder a la información devuelta en OutputBuffer.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows 8 |
| encabezado de |
ntifs.h |
Consulte también
fltFsControlFile de