FSCTL_QUERY_FILE_REGIONS IOCTL (ntifs.h)

Artículo
03/05/2024

FSCTL_QUERY_FILE_REGIONS consulta una lista de regiones de archivo, según 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 a la 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/D

Longitud del búfer de entrada y salida

N/D

Bloque de estado

Reservado para uso del sistema.

Comentarios

Para realizar esta operación, llame a FltFsControlFile o ZwFsControlFile con los parámetros siguientes.

Parámetro	Descripción
Instancia	[in] Solo para FltFsControlFile . Puntero de instancia opaco para el autor de la llamada. Este parámetro es obligatorio y no puede ser NULL.
FileObject	[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 obligatorio y no puede ser NULL.
FileHandle	[in] Solo para ZwFsControlFile . Identificador de archivo del archivo o directorio que es el destino de esta solicitud. Este parámetro es obligatorio y no puede ser NULL.
IoStatusBlock	[out] Solo para ZwFsControlFile . Puntero a una estructura de 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 InputBuffer apunta, 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 completarse correctamente; de lo contrario, devuelve un código de error. Al finalizar correctamente, el autor de la llamada debe comprobar primero que IoStatus.Information es mayor o igual que LengthReturned antes de acceder a la información devuelta en OutputBuffer.