FSCTL_QUERY_FILE_REGIONS IOCTL (ntifs.h)
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 de 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 de FILE_REGION_INPUT que inputbuffer aponta para, 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 que OutputBuffer aponta para, em bytes.
Buffer de entrada/saída
n/a
Comprimento do buffer de entrada/saída
n/a
Bloco de status
Reservado para uso do sistema.
Observações
Para executar essa operação, chame FltFsControlFile ou ZwFsControlFile com os parâmetros a seguir.
| Parâmetro | Descrição |
|---|---|
| da Instância de |
[in] Para FltFsControlFile. Um ponteiro de instância opaco para o chamador. Esse parâmetro é necessário e não pode ser NULL. |
| FileObject | [in] 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. |
| |
[in] Para ZwFsControlFile. Identificador de arquivo do arquivo ou diretório que é o destino desta solicitação. Esse parâmetro é necessário e não pode ser NULL. |
| IoStatusBlock | [out] Para ZwFsControlFile. Ponteiro para uma estrutura IO_STATUS_BLOCK na qual o status final da solicitação é retornado. |
| FsControlCode | [in] Definido 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 que InputBuffer aponta para, 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 que OutputBuffer aponta para, em bytes. |
| LengthReturned | [out] Ponteiro para uma variável alocada por 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, ele retorna 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.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows 8 |
| cabeçalho | ntifs.h |
Consulte também