FSCTL_QUERY_FILE_REGIONS IOCTL (ntifs.h)

Artigo
02/26/2024

FSCTL_QUERY_FILE_REGIONS consulta uma lista de regiões de arquivo, com base em um parâmetro de uso especificado, para o arquivo associado ao identificador no qual esse FSCTL foi invocado. Esta mensagem contém um elemento de dados FILE_REGION_INPUT opcional. Se nenhum parâmetro FILE_REGION_INPUT for especificado, as informações para todo o tamanho do arquivo serão retornadas.

Código principal

FSCTL_QUERY_FILE_REGIONS

Buffer de entrada

Ponteiro para uma estrutura de FILE_REGION_INPUT que indica as regiões de arquivo a serem consultadas.

Comprimento do buffer de entrada

Tamanho da estrutura FILE_REGION_INPUT para a qual InputBuffer aponta, em bytes.

Buffer de saída

Ponteiro para uma estrutura FILE_REGION_OUTPUT na qual os resultados da consulta são retornados.

Comprimento do buffer de saída

Tamanho do buffer para o qual OutputBuffer aponta, em bytes.

Buffer de entrada/saída

n/d

Comprimento do buffer de entrada/saída

n/d

Bloco de status

Reservado para uso do sistema.

Comentários

Para executar essa operação, chame FltFsControlFile ou ZwFsControlFile com os parâmetros a seguir.

Parâmetro	Descrição
Instância	[in] Somente para FltFsControlFile . Um ponteiro de instância opaco para o chamador. Esse parâmetro é necessário e não pode ser NULL.
FileObject	[in] Somente para FltFsControlFile . Um ponteiro de objeto de arquivo para o arquivo ou diretório que é o destino dessa solicitação. Esse parâmetro é necessário e não pode ser NULL.
FileHandle	[in] Somente para ZwFsControlFile . Identificador de arquivo do arquivo ou diretório que é o destino dessa solicitação. Esse parâmetro é necessário e não pode ser NULL.
IoStatusBlock	[out] Somente para ZwFsControlFile . Ponteiro para uma estrutura IO_STATUS_BLOCK na qual a status final da solicitação é retornada.
FsControlCode	[in] Defina como FSCTL_QUERY_FILE_REGIONS.
Inputbuffer	[in/optional] Ponteiro para uma estrutura de FILE_REGION_INPUT que indica as regiões de arquivo a serem consultadas.
InputBufferLength	[in] Tamanho do buffer para o qual InputBuffer aponta, em bytes.
OutputBuffer	[out] Ponteiro para uma estrutura FILE_REGION_OUTPUT na qual os resultados da consulta são retornados.
OutputBufferLength	[out] Tamanho do buffer para o qual OutputBuffer aponta, em bytes.
LengthReturned	[out] Ponteiro para uma variável alocada pelo chamador que recebe o tamanho em bytes das informações retornadas no buffer em OutputBuffer.

Valores retornados

FSCTL_QUERY_FILE_REGIONS retorna STATUS_SUCCESS após a conclusão bem-sucedida; caso contrário, retornará um código de erro. Após a conclusão bem-sucedida, o chamador deve primeiro verificar se IoStatus.Information é maior ou igual a LengthReturned antes de acessar as informações retornadas no OutputBuffer.